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PREFACE 


This manual is intended for system administrators and operators 
of an OS/32 Multi-Terminal Monitor (MTM) System. It describes 
step-by-step procedures for installing and operating an MTM 
system that is tailored to meet the needs of a particular 
organization. 


Chapter 1 decribes MTM and lists the system requirements’ and 
basic steps in configuring an MTM system. It also lists the 
recommended OS/32 system generation (sysgen) options that improve 
MTM efficiency. Chapter 2 describes the MTM sysgen procedure and 
defines the MTM sysgen procedure options and has been 
restructured. Chapter 3 describes building, loading, and 
starting the authorized user utility. It also lists the 
authorized user utility commands. Chapter 4 discusses the 0S/32 
accounting facility option. Chapter 5 describes the operating 
procedures needed to load, start, and control MTM. Appendix A 
lists the MTM sysgen options summary. Appendix B summarizes’ the 
authorized user utility commands. Appendix C is an authorized 
user utility message summary. Appendix D contains the accounting 
transaction file (ATF) record formats. Appendix E lists the MTM 
“operator commands. 


Revision O02 of this manual describes the use of the following 
additional or enhanced MTM sysgen options: 

e batch job pause 

e default system volume 

e MTM subtask scheduling 

e@ SPL/32 interface 

@® number of new global variables 

@ number of internal variables 

@ HASP interface 

e CPU limit for accounting user classes 


@e input/output (1/0) count limit for accounting user classes 
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Also described are the account privileges that can be added to or 
changed through the authorized user utility and the USED 
parameter to the .MTM command. 


This manual is intended for use with the 0OS/32 R06.2 software 
release and higher. 


For further information on the contents of all Perkin-Elmer 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
GENERAL DESCRIPTION 


1.1 INTRODUCTION 


The OS/32 Multi-Terminal Monitor (MTM) is an interactive 
multi-terminal, time-sharing system that executes as an executive 
task (e-task) in an OS/32 environment. MTM can be loaded, 
started, and cancelled without disrupting the execution of other 
tasks running concurrently under 0OS/32. All tasks loaded and 
started from a user terminal execute as subtasks of MTM. Figure 


1-1 shows the relationship of application tasks to OS/32 and MTM 
in a typical MTM system environment. 
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Figure 1-1 MTM System Environment 


48-023 FOO RO2 


1.2 MULTI-TERMINAL MONITOR (MTM) SYSTEM REQUIREMENTS 

The minimum hardware and software requirements for configuring an 
MTM system are: 

@ OS/32 RO6.2 

e Perkin-Elmer processor 


@ Memory access controller (MAC) or memory address translator 
(MAT) (as appropriate) 


e Universal clock module 
@e Power fail/auto restart option 
e Console device 


@e Relocating (REL) loader, bootloader, or loader storage unit 
(LSU) to load the operating system 


@ 256kb of memory (288kb or greater is recommended) 
e 10Mb disk device 


e ASCII terminal device 


1.3 CONFIGURING A MULTI-TERMINAL MONITOR (MTM) SYSTEM 

The following procedure is used to configure an MTM system. 

l. Perform an OS/32 system generation (sysgen). See the 0S/32 
System Generation/32 (Sysgen/32) Reference Manual. 


2. Unpackage the MTM software. See the MIM packaging document 
for instructions. 


3. Perform an MTM sysgen, modifying the MIM sysgen options to 
reflect the requirements of your installation. See Chapter 
2. 


4. Build an authorized user file (AUF), using the authorized 
user utility described in Chapter 3. 


5. Load and start MTM. See Chapter 5. 


L=2 48-023 FOO RO2 


1.4 O8S/32 SYSTEM GENERATION (SYSGEN) OPTIONS 


When generating an operating system for an MTM system, select the 
following sysgen options to improve the overall efficiency and 
effectiveness of the system: 


e Secondary directory support - this option adds a 
memory-resident directory to the system to reduce file search 
time. 


@® Segmentation support - this option allows the task image to be 

segmented into a private image area containing impure code and 
a shared image area containing pure _ code. During multiple 
simultaneous executions of the task, a copy of the private 
image is loaded into memory for each user, but only one _ copy 
of the shared image is loaded. 


@ Roll support - this option ensures that MTM can service a 
number of tasks in a limited amount of memory space. 


@ Spool support - this option provides input and output spooling 
capabilities to the MTM user. 


@e Accounting support - this option is required if the 08/32 
accounting facility is to be used with MTM. See Chapter 4. 


1.5 FILE DESCRIPTORS 


Many of the command formats in this manual require the user _ to 
enter a file descriptor (fd). File descriptors are entered in 
the following format. 


Format: 


ent] [filename . [ext] ] /\ eae 


dev: file class 


Parameters: 
voln: is the name of a disk volume. It may be from 
l- to 4-characters. The first character must 
be alphabetic and the remaining, alphanumeric. 
If voln: is not specified, the default volume 
specified by the VOLUME command is used. 
dev: is a l- to 4-character device name. The first 


character must be alphabetic and the 
remaining, alphanumeric. 
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filename is the name of a file and is from 1- to 
8-characters. The first character must be 
alphabetic and the remaining, alphanumeric. 
If a filename is specified when a device 
mnemonic is specified as voln:, the filename 
is ignored. 


ext is the name of the extension and consists of 
from 1- to 3-alphanumeric characters. For 
some commands, extensions are appended by 
default. If the period is omitted, the 
default is blanks. 


actno is a decimal number ranging from 0 - through 
65,535 specifying the account number 
associated with the file. Account numbers 1 
through 65,535 are used by MtTM. Account 
number 255 is a restricted account. MTM uses 
account 255 for the authorized user file 
(AUF). Account number 0 is used for system 
files and is the default for all operator 
commands entered from the system _ console. 
Tasks must have account privileges to specify 
an account number in this field. 


file class is the class name of the file and consists of 
one character. The class names are: 
e P for private file 
e G for group file 


e S for system file 


NOTE 


The file class can be specified by a 
terminal user or the system operator. If 
the system operator specifies P, G, or S, 
the operation is performed to account 0 
only. 
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CHAPTER 2 
MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION (SYSGEN) 


2.1 INTRODUCTION 


This chapter describes MIM sysgen procedures and options 
available for configuring an MTM system. 


The MTM task consists of two modules: 


@ MTMMAIN 


e MTMSGN 


MTMMAIN is a fixed length object file containing the executable 
code for MTM. 


MTMSGN is a source file containing the MTM sysgen options. These 
options can be modified to meet the requirements of your 
installation. 


The procedure for performing an MTM sysgen is as follows: 


e Select the MTM sysgen options that pertain to your 
installation. 


e Use the command substitution system (CSS) command file 
(MTMSGN.CSS) to build the MTM task. 


The following sections describe the MTM sysgen procedure in 
detail. 


2.2 SELECTING MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION 
(SYSGEN) OPTIONS 


MTMSGN is a source module that contains information necessary to 
configure an MTM system that meets the requirements of a 
particular installation. For example, one data field in this 
file tells MTM how many users can be signed on the system 
concurrently. Another data field tells MTM how many command 
buffers to reserve in memory. See Section 2.4 for a complete 
description of the sysgen options contained in this file. 
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Perkin-Elmer supplies a standard MTM sysgen parameter file 
(MTMPARMS.MAC) with the MTM package. This file contains the 
following code: 


**XMTM.SGN 


SGN.ACT EQU 
SGN.SCHR EQU 
SGN.ROLL EQU 


0 NO ACCOUNTING SUPPORT 

1 O=NONE / 1=DYNAMIC / 2=PSM 

1 FORCE TASK ROILLABLE 
SGN.PRIO EQU 6 BATCH PRIORITY 
SGN.BTCP EQU 0 CANCEL BATCH JOB ON PAUSE 
SGN.SPL EQU 0 NO SPL/32 SUPPORT 
SGN.$HSP EQU 0 NO $HASP INTERFACE SUPPORT 
SGN.MVOL EQU c' : NO DEFAULT USER VOLUME 
SGN.VAR EQU 28 NUMBER OF VARIABLES 


SGN.@GLO EQU 18 NUMBER OF GLOBAL VARIABLES 
SGN.@INT EQU 8 NUMBER OF INTERNAL VARIABLES 
NUSERS EQU 4 NUMBER OF USERS 
NCSSLVS EQU 8 NUMBER OF CSS LEVELS 
NCSBFS EQU 10 NUMBER OF EXTRA CSS BUFFERS 
NCONBFS EQU 0 NUMBER OF CONSOLE BUFFERS 
NSECTS EQU NUSERS /2 NUMBER OF SECTOR BUFFERS 
NMSGS EQU NUSERS NUMBER OF MESSAGE BUFFERS 
QUESIZE EQU NUSERS SIZE OF TASK QUEUE 
CSBFSZ EQU 80 SIZE OF CSS BUFFERS 
CONBFSZ EQU 0 SIZE OF CONSOLE BUFFERS 
CDBUFSIZ EQU 3 SIZE OF SECTOR BUFFERS 
CPULIMIT EQU 0 NO CPU TIME LIMIT 

SPACE 2 

LINKOPT 4,30 LINK OPTIONS IOB, LU 


In addition, MTMSGN defines values for the prompt sequence, the 
input/output (1/0) class table, user I/O limits, and user central 
processing unit (CPU) limits. See the I[OTAB, UIOLIM, UCPULIM, 
PRMTSEQ, and PRMTDEV macro instructions in Section 2.4 for more 
information on the default values for these sysgen options. 


MTM sysgen options that differ from those defined by the standard 
MTM sysgen parameter file (MTMPARMS.MAC) can be _ selected by 
editing MTMPARMS.MAC via Edit/32. 


In the following example, MTMPARMS.MAC is edited to permit five 
accounting classes, SPL/32 and HASP support, assignment of a user 
default volume, 25 concurrent users, larger CSS buffers, and an 
increased number of I/O blocks and logical units. In addition, 
several macro calls have been appended to MTMPARMS.MAC. 
Discussion of these macro calls is deferred until their 
respective sections in this chapter. Identification name '3230-B 
System’ is assigned to this MTM system. 
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* X*MTM.SGN 


SPACE 2 
VERSION '3230-B SYSTEM' 
SPACE 2 
SGN.ACT EQU 5 5 ACCOUNTING CLASSES 
SGN.SCHR EQU) 1 O=NONE / 1=DYNAMIC / 2=PSM 
SGN.ROLL EQU 1 FORCE TASK ROIJLABLE 
SGN.PRIO EQU- 6 BATCH PRIORITY 
SGN.BTCP EQU 0 CANCEL BATCH JOB ON PAUSE 
SGN.SPL EQU 25 SPL/32 SUPPORT - 25 BUFFERS 
SGN.$HSP EQU- 1 1 $HASP INTERFACE 
SGN.MVOL EQU  C'MTM ' DEFAULT USER VOLUME - MIM 
SGN.VAR EQU 28 NUMBER OF VARIABLES 
SGN.@GLO EQU = _15 NUMBER OF GLOBAL VARIABLES 
SGN.@INT EQU- 8 NUMBER OF INTERNAL VARIABI.ES 
NUSERS EQU = 25 NUMBER OF USERS 
NCSSLVS EQU- 8 NUMBER OF CSS I.EVFILS 
NCSBFS EQU- 10 NUMBER OF EXTRA CSS BUFFERS 
NCONBFS EQU 0 NUMBER OF CONSOLE BUFFERS 
NSECTS EQU  NUSERS/2 NUMBER OF SECTOR BUFFERS 
NMSGS EQU  NUSERS NUMBER OF MESSAGE BUFFERS 
QUESIZE EQU  NUSERS SIZE OF TASK QUEUE 
CSBFSZ EQU_ 120 SIZE OF CSS BUFFERS 
CONBFSZ EQU- 0 SIZE OF CONSOLE BUFFERS 
CDBUFSIZ EQU- 3 SIZE OF SECTOR BUFFERS 
CPULIMIT EQU 0 NO CPU TIME LIMIT 
SPACE 2 
LINKOPT 25,80 LINK OPTIONS 10B, LU 
SPACE 2 
IOTAB (0, INDX),(1,CNTG),(2,DEV),(3,SPL),(4,TAPE) 
SPACE 2 
UCPULIM 30,30,,,40,3600,80, 10800 
SPACE 2 
ULOLIM (00,01,02,03,04),(100,101,102,103,104), U CLS 0 * 
(10,11,12,13,14),, U CLS 1 * 
(20,21,22,23,24),(120,121,122,123,124), U CLS 2 * 
(30,31,32,33,34),(130,131, 132,133,134) U CLS 3 
SPACE 2 
PRMTDEV (FOX,CT30,CT32,CT34), x 
(SIGMA, SM50) 
SPACE 2 
PRMTSEQ (FOX,(*,O8FF),(-,O8FF),(>,FF),(BUIID>,FF)), * 
(SIGMA) 


It is recommended that the MTM sysgen parameter file that results 
from editing MTMPARMS.MAC be saved with a different extension. 
For example, MTMPARMS.MAC can be edited as above, with the new 
file saved as MTMPARMS.xxx where xxx is a 1- to 3-character 
alphanumeric extension. For a further explanation of this 
parameter, see Section 2.3. 


See the 0S/32 Edit User Guide for information on editing files. 
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2.3 GENERATING A MULTI-TERMINAL MONITOR (MTM) SYSTEM USING THE 
STANDARD COMMAND SUBSTITUTION SYSTEM (CSS) COMMAND FILE 
(MTMSGN.CSS) 


Perkin-Elmer supplies a CSS command file (MTMSGN.CSS) with the 
MTM package. MTMSGN.CSS assigns the SYSSTRUC.MLB macro library. 
Therefore, MTMSGN.CSS may have to be edited via Edit/32 to 
reflect the location of this file for a particular installation. 
For example, a volume and/or account classification, i.e., S, G, 
P, may have to be specified for SYSSTRUC.MLB. 


To call the standard CSS command file, enter the command as 
follows: 


Format: 
XXX 
MTMSGN. 
MAC 
Parameter: 
XXX is a l1l- to 3-character alphanumeric field 


which must be preceded by a space. 


Functional Details: 


The parameter specified in the MTMSGN command must match the 
extension specified for the MTM sysgen parameter file (MTMPARMS). 
If the edited MTM sysgen parameter file was not saved with an 
extension different from that of the standard MTM sysgen 
parameter file, or the standard file is being used, MAC must be 
specified. 


Successful execution of MTMSGN.CSS returns condition code = 0 
upon completion of the MACRO/32 and CAL/32 processing phases. 


Upon completion of the Link phase of MTMSGN.CSS, condition 
code = 1 is returned with the following message: 


*** WARNING: ABSOLUTE SPACE LESS THAN 100 *** 
2.4 MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION (SYSGEN) 
OPTIONS 


The MTM sysgen options are: 


e cCDBUFSIZ - Sector buffer size 


@ CONBFSZ - Special console buffer size 
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@® CPULIMIT 


Batch job CPU Limit 


e@ CSBFSZ 


Command buffer size 
e@ IOTAB - I/O class table 


@ LINKOPT - Number of I/O blocks and logical units for the LINK 
OPTION command 


@ NCONBFS - Number of special console buffers 
@ NCSBFS-~- - Number of command buffers 


@e NCSSLVS - Number of CSS levels 


e NMSGS - Number of message buffers 
e NSECTS - Number of sector length buffers 
@ NUSERS - Number of concurrent users 


@ PRMTDEV - MTM terminal prompt device name 

@ PRMTSEQ - MTM terminal prompt sequence 

@ QUESIZE - MTM task queue size 

@e SGN.ACT - Number of accounting classes 

e@ SGN.BTCP - Batch job pause 

e SGN.MVOL - Default user volume 

@ SGN.PRIO - Batch job relative priority 

@e SGN.ROLL - Forced roll 

@ SGN.SCHR - Scheduling mechanism 

e@ SGN.SPL - Number of SPI./32 send data buffers 
e SGN.VAR - Number of global and local variables 
e@ SGN.@GLO - Number of new global variables 

® SGN.@INT - Number of internal variables 

@ SGN.$HSP - HASP interface 


e@ UCPULIM 


j 


CPU Limit for each accounting user class 
e UIOLIM - I/O count Limit for each accounting user class 


@ VERSION 


MTM version identification 
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2.4.1 Sector Buffer Size (CDBUFSIZ) Option 


The sector buffer size (CDBUFSIZ) option specifies the number of 
sectors in a sector length buffer. For example, using this 
option to increase the length of the buffers for the DISPLAY 
FILES and variable-related commands causes a corresponding 
increase in the speed of MTM. The standard MTMPARMS file 
specifies a value of 3 for this option. To modify the standard 
value, edit this option to the following: 


Format: 


CDBUFSIZ EQU n 


Parameters: 


n is a decimal number from 0 through 6. 


Functional Details: 


The size of each sector buffer is set according to this formula: 


(CDBUFSIZ*256) +256 


The use of this option to increase the speed of the DISPLAY FILES 
command pertains only to files on disks that have been marked on 
with a secondary directory. The number of sectors calculated by 
the CDBUFSIZ option are read from the SYSTEM.DIR file each time 
a DISPLAY FILES command is executed. If the disk is marked on 
with a secondary directory that can be contained in memory, MTM 
scans the memory buffer to search the directory. If CDBUFSIZ is 
set to 0, MTM does not scan the secondary directory to get the 
desired files. Instead, the primary directory is scanned. 


When variable support is included in an MTM system, the size and 
number of sector buffers allocated determine the number of 
variables that can be contained in memory. Sometimes, a user 
will attempt to define more variables than can fit into the. 
user's allocated sector buffers. When this occurs, one of the 
allocated sector buffers is paged to disk, and a freed sector 
buffer is made available to the user. This allows the user to 
define more variables. 
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2.4.2 Special Console Buffer Size (CONBFSZ) Option 


The CONBFSZ option specifies the maximum length of the special 
console buffers generated by the NCONBFS' option. Since no 
special console buffers are reserved by the standard MTMPARMS 
file, the standard value of this option is 0. To specify the 
maximum length of each special console buffer reserved by MIM, 
edit this option to the following: 


Format: 


CONBFSZ EQU n 


Parameters: 


n is 0 or a decimal number from 72 through 
32,767 specifying the length of each special 
console buffer in the system. If the standard 
value of this option is changed, the value of 
n should be greater than the number specified 
in the command buffer length (CSBFSZ) option. 
See Section 2.4.4. 
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2.4.3 Batch Job Central Processing Unit (CPU) Limit (CPULIMIT) 
Option 


The batch job CPU limit (CPULIMIT) option defines the maximum CPU 
time (in seconds) for a batch job running under MTM. No CPU 


Limit is set by the standard MTMPARMS file. To set the CPU time 
limit, edit this option to the following: 


Format: 


CPULIMIT EQU n 


Parameters: 


n is a decimal number from 0 through 86,400 (24 
hours) specifying the maximum CPU time (in 
seconds) to which each batch job is’' limited. 
If 0 is specified, no limit applies. 
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2.4.4 Command Buffer Size (CSBFSZ) Option 


The command buffer length (CSBFSZ) option sets the maximum Length 
of the MTM system command buffers, including the buffers used for 
command substitution system (CSS) commands. The standard value 
for this option is 80. To modify the standard value, edit this 
option to the following: 


Format: 

CSBFSZ EQU n 
Parameter: 

n is a decimal number from 72 through 1,024. 
Functional details: 


The user should define a command buffer length one greater than 
needed. If a number less than 72 is specified for n, a message 
is output and MTM goes to end of task code 7 when the .MTM START 
command is entered. 
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2.4.5 Input/Output (1/0) Class Table (IOTAB) Macro 


The I/O class table (IOTAB) macro defines values for the I/0 
class table. To change the default values, enter the IOTAB macro 
instruction as follows: 


Format: 


[label] IOTAB (classno,classid [, iocount] ), 


fe 


(classno,classid [, iocount] )pj 


Operand: 


classno 


classid 


Liocount 


Functional Details: 


is a decimal number from 0 through 31 
specifying a device or file class number. 


is a user-specified 4-character alphanumeric 
class identification associated with each 
device or file class. The classid is 
installation dependent. 


is a decimal number from 0 through 1,000,000 
specifying the maximum number of I/O transfers 
to which each batch job associated with a 
particular device or file class is limited. 
If iocount is omitted, the default is O (no 
Limit on I/O transfers). 


MTMSGN defines default values for the first four classes of the 


I/O class table as 


follows: 


IOTAB (0, INDX,0),(1,CNTG,O),(2,DEV,0),(3,SPL,0) 


These default values may be modified by appending the IOTAB macro 
call, with the desired parameters, to the MTMPARMS.xxx file, as 
demonstrated in Section 2.3. 
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2.4.6 Multi-Terminal Monitor (MTM) Link (LNKOPT) Option 

The MTM link (LNKOPT) option sets the maximum number of I/0 
blocks and logical units available to MTM. The standard MTMPARMS 
file permits four I/O control blocks and 30 logical units. To 


modify the standard values of LNKOPT, edit this option to the 
following: 


Format: 
LNKOPT n,m 
Parameters: 
n is the maximum number of I/0 control blocks 
available to a task. 
m is the maximum number of logical units 
available to a task. 
Functional Details: 
The number of I[/O control blocks should equal the number of 
concurrent users (NUSERS) set by MTMPARMS. 
The minimum number of logical units that should be specified can 
be determined by the following formula: 


lu =6+(NCSSLVS+1)*NUSERS or 254, whichever is smaller. 


MTM dynamically allocates logical units to subtasks as needed. 
The actual number of logical units available to MTM for dynamic 
allocation can be calculated as follows: 


available logical units = (number of logical units specified 
at MTM sysgen (LNKOPT)) - NUSERS-6. 


To avoid a decrease in response time, the recommended number of 
logical units for NUSERS greater than 5 is: 


6+NUSERS * 2+ (NCSSLVS* 2) 
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To determine if the number of logical units specified by LNKOPT 
is sufficient, check the number of times MTM goes into a logical 
unit (lu) wait state by using the .MTM STATUS,WAITS command. 
This command returns a table similar to the one shown below. 


-MTM ST,W 
13:14:32 -MTM: TOTAL PEAK CURRENT WAITS 
13:14:34 -MTM: 42 34 11 0 CMD BUFFERS 
13214:37 -MTM: 0 0 0 0 CON BUFFERS 
13:14:40 -MTM: 7 4 0 0 SEC BUFFERS 
13:14:42 -MTM: 50 24 19 0 LU 


A decision to increase or decrease the number of logical units 
specified by LNKOPT can be based on information returned by .MTM 
STATUS ,WAITS. 
The MTMMAIN object module has the following LINK OPTION commands 
imbedded: 

OPTION COMMUNICATION, CONTROL, XSVC1,ETASK, INTERCEPT, ABSOLUTE=0 
These options can be overridden by using the NDCMD command to 


suppress imbedded LINK options. 


The LINK OPTIONS IOBLOCKS and LU are contained in the MTMSGN 
source module. These options are selected as decribed above. 


For more information on LINK commands and OPTIONS, see the 0OS/32 
Link Reference Manual. 
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2.4.7 Number of Special Console Buffers (NCONBFS) Option 


The NCONBFS option specifies the maximum number of special 
console buffers that can be used concurrently during MTM 
execution. No special console buffers are specified in the 
standard MTM sysgen parameter file. To specify the number of 
special console buffers to be reserved, edit this option to. the 
following: 


Format: 

NCONBFS EQU n 
Parameters: 

n is a decimal number from 0 through 64. 
Functional Details: 


The maximum number of special console buffers that can be used at 
one time is equal to the number of users (NUSERS). These special 
console buffers are used only when an I/O request is made to a 
user terminal that requires an I/O buffer larger than the size 
specified in the command buffer length (CSBFSZ) option. An 
example of this is the use of graphic buffers. 


Table 2-1 shows the types of buffers used in different 
situations. 


TABLE 2-1 BUFFER TYPES USED FOR 
SPECIFIC I/O REQUESTS 


Cee eee ee ee ee 


I/O REQUEST SIZE } READ i WRITE H 
| <¢ CSBFSZ ' TUB i TUB ' 
Ba on at a CT agg cea gels oe Saas aR a up 
| >» CSBFSZ and H H H 
H < CONBFSZ } CON i CON | 
 Haciaaiiay eeriienis Re Sa ee Si eee ie esac fs ice 
} > CSBFSZ | TRUNCATE | | 
\ and 1 to H H 
| CONBFSZ = 0 | CSBFSZ H DIRECT H 
[eS oe See See ee Se aS Se SSeS SS SSS H 
} > CONBFSZ | TRUNCATE } H 
H {| to | { 
| | CONBFSZ i DIRECT | 
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TUB (terminal Dedicated buffer of size CSBFSZ for each user. 
buffer) 


CON (console) Special console buffer of size CONBFSZ. 


TRUNCATE Read request will be truncated. 
DIRECT Write request will be performed directly from 
the task. The task is made nonrollable for 


the duration of the I/O call. 


The decision to buffer large writes through the special console 
buffers, or to perform the write directly from the task, should 
be based on: 


e the speed of the terminal, 
@® the size of the write, and 


e the impact on other system users caused by the user task 
(u-task) being nonrollable for the duration of the write 
request. 


If an insufficient number of console buffers is allocated, a 
deadlock between two tasks might occur; e.g., both tasks enter 
into a console buffer wait state. If this happens, one of the 
two tasks involved should be cancelled. This deadlock situation 
is likely to occur if the special console buffers are used for 
read purposes and there is an insufficient amount of task space 
causing tasks to be rolled. To monitor the number of console 
buffer waits, enter the .MTM STATUS parameter with a WAITS 
option. 
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2.4.8 Number of Command Buffers (NCSBFS) Option 

The MIM program requires a minimum number of command buffers as 
follows: 

ee One buffer for Back user (terminal or batch job) 

@e One buffer for each active CSS level 

e@e One buffer for each MESSAGE command 

@ One buffer for each BROADCAST message 


e One buffer for each new global or new internal variable 


MTM terminal response time depends on the number of available 


command buffers. To avoid poor performance, an adequate number 
of buffers must be allowed for MTM use. During MTM sysgen, three 
command buffers are reserved for each user. However, additional 


buffers can be reserved according to the number of CSS levels 
that can be active under MTM. The NCSBFS option tells MTM how 
many additional command buffers are to be reserved. The length 
of these command buffers is specified by the CSBFSZ option. The 
standard value for the NCSBFS option is 10. 


To modify the standard value, edit this option to the following: 
Format: 

NCSBFS EQU n 
Parameters: 


n is a decimal number specifying the number of 
additional command buffers that can be used by 
the MTM system. Use the following formula to 
calculate n for your installation: 


n = (number of users) x (number of CSS 
levels +1)/3. 


The minimum number for n is O. 
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Functional Details: 


Response time may be adversely affected if the value specified 
for n is too small. Conversely, memory space is wasted if n is 
set above the maximum buffers needed. 


The program development feature of MTM uses new global and new 
internal variables extensively. A user who plans to employ the 
program development feature, or expects to use a large number of 
new global and new internal variables, may require a large number 
of command buffers. The recommended minimum number of extra 
command buffers that should be specified by users of the program 
development feature is 15. 


The following methods can be used to judge whether the value 
specified for n is too small or too large for your system: 


@ Terminate MTM with the .MTM QUIESCE command. At end of task, 
MTM outputs the number of times it had to wait to geta 
command buffer. . 


@e Enter .MTM STATUS,WAITS at the system console. This command 
displays the total number of buffers available, peak usage, 
current usage, and the number of times MTM had to wait for 
system resources on the user's behalf. 


e Enter .MTM STATUS, USED at the system console. This command 


displays in histogram form the number of times command buffers 
were used during MTM execution. 
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2.4.9 Number of Command Substitution System (css) Levels 
(NCSSLVS) Option 


The number of CSS levels (NCSSLVS) option sets the maximum 
nesting depth of CSS routines. If one CSS routine tries to call 
another and exceeds the designated depth, the system responds 


with an error message and CSS processing ceases. To modify the 
standard value, edit this option to the following: 


Format: 


NCSSLVS EQU n 


Parameters: 


n is a decimal number specifying the maximum 
number of CSS levels. The minimum value for 
n is one; the maximum value is 1,024. 
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2.4.10 Number of Message Buffers (NMSGS) Option 
The number of message buffers (NMSGS) option defines the maximum 
number of message buffers that MTM can reserve for operator 
commands and accounting messages from the file manager. The 
standard value for this option is NUSERS. 
To modify the standard value, edit this option to the following: 
Format: 

NMSGS EQU n 


Parameters: 


n is a decimal number from 1 through 1,024. A 
recommended value for n is NUSERS. 


Functional Details: 


MTM reserves 76 bytes per buffer. If these buffers overflow, the 
following message is displayed by the operating system: 


SVC6-ERR TYPE=NMSG POS= 


2-18 48-023 FOO RO2 


2.4.11 Number of Sector Length Buffers (NSECTS) Option 


The number of sector length buffers (NSECTS) option specifies the 
maximum number of sector length buffers that can be used by MTM 
for commands that require this buffer type. These commands are 
DISPLAY FILES, $GLOBAL, $LOCAL, $SET, and $FREE. The number of 
sector length buffers specified by the standard MTMPARMS file is 
NUSERS/2. To modify the standard value, edit this option to the 
following: 


Format: 
NSECTS EQU n 
Parameters: 


n is a decimal number specifying the maximum 
number of 256-byte sector buffers. The 
minimum value for n is 1. A recommended value 
for n is NUSERS/2. 


Functional Details: 


When variable support is included in an MTM system through the 
SGN.VAR option, a sufficient amount of sector buffers should be 
reserved to hold MIM variables. A 256-byte (one sector) buffer 
can contain a maximum of seven variables. The amount of sector 
buffers needed depends on the number of users, the number of 
variables being used, and the size of the _ sector buffers. 
Ideally, two 256-byte sector buffers per user should be 
allocated; a maximum of four sector buffers per user can be 
allocated to a sector buffer pool. Very large sector buffers can 
also be allocated using the sector buffer size (CDBUFSIZ) option. 
If an insufficient number of sector buffers is allocated, the 
buffer pool. can run empty, causing the user to go into a sector 
buffer wait state. 


When variable information is not required, sector buffers are 
paged to disk. The resulting freed buffers are returned to the 
sector buffer pool. Because of this paging to and from disk, the 
size of each sector buffer is an important factor in processing 
variables. 
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2.4.12 Number of Concurrent Users (NUSERS) Option 


The number of concurrent users (NUSERS) option defines’ the 
maximum number of terminal users and batch jobs that can be 
executed concurrently. The value specified for this option in 
.-the standard MTMPARMS file is 4. To modify the standard value, 
edit this option to the following: 


Format: 


NUSERS EQU n 


Parameter: 


n is a decimal number from 1 through 64. 
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2.4.13 Multi-Terminal Monitor (MTM) Terminal Prompt Device 
Name (PRMTDEV) Macro 


The PRMTDEV macro defines the devices to be used with the prompt 
sequences specified in the PRMTSEQ macro. Any terminal device 
not defined by the PRMTDEV macro will use the standard prompt 
sequences. The PRMTDEV macro is used as follows: 


Format: 


[label] PRMTDEV (pname, ,dev, [...,devn]), 
[ .,(pnamen,dev;, [,... devn })n] 


[abel] PRMTDEV (SIGMA,dev, [,...,devn] ) 


Operands: 


pname is the 1- to 8-character prompt sequence name 
specified in the PRMTSEQ option. See Section 
2.4.14. 

dev is the device name of the terminal. 

SIGMA is the predefined prompt sequence for the 


Perkin-Elmer SIGMA 10 terminal. 


Example: 


PRMTDEV (FOX,CT30,CT32,CT34), (SIGMA, SM50) 
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2.4.14 Multi-Terminal Monitor (MTM) Terminal Prompt Sequence 
(PRMTSEQ) Macro 


The PRMTSEQ macro defines prompt sequences for terminals 
requiring special prompt sequences. This macro is used in 
conjunction with the MTM terminal prompt device name (PRMTDEV) 
macro. This macro is only required if the user wishes to use a 
terminal prompt sequence other than the standard sequence. 


Format: 


[label] PRMTSEQ (SIGMA) 


[Label] PRMTSEQ (pname, , (com-req,x),(task-exec,x), 
(task-read,x), (build-read,x)), 
(pnamen , (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x) ),| 


[label] PRMTSEQ (STANDARD, (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x), 


Parameters: 

SIGMA requests the predefined prompt sequence for 
the Perkin-Elmer SIGMA 10 terminal. 

pname is a l- to 8-character alphanumeric prompt 
sequence name beginning with an alphanumeric 
character. This parameter corresponds to that 
specified for the PRMTDEV macro. 

com req is 0 to 8 ASCII characters defining the prompt 
sequence for a command request. 

task exec is 0 to 8 ASCII characters defining the prompt 
sequence for task or CSS execution. 

utask read is 0 to 8 ASCII characters defining the prompt 
sequence for a user task read. 

build read is 0 to 8 ASCII characters defining the prompt 


sequence for a build read. 
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STANDARD redefines the standard prompt sequence’ which 


is as follows: 


: command read (*,FFFFFF ) 

@ task/CSS executing (-,FFFFFF) 
@e user task read (),FFFFFF) 

e build read (B>),FFFFFF) 


x is a hexadecimal pad sequence from 
bytes. 


Functional Details: 


The total length of the ASCII character sequence 
hexadecimal pad sequence cannot exceed 8 bytes. 


When specifying more than one set of prompt sequences, 
must be placed immediately following the last parameter 


0 to 8 
and the 
a comma 


specified 


on a line, and an asterisk must appear in column 72 to designate 


continuation of the operands. 


Example: 


PRMTSEQ (BS, (*,O8FF),(-,O8FF),(>,FF),(BUILD),FF)), 
(SIGMA) 
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2.4.15 Multi-Terminal Monitor (MTM) Task Queue Size 
(QUESIZE) Option 

The task queue size (QUESIZE) option specifies the maximum size 

of the task queue used by MT. The standard MTMPARMS file 


specifies NUSERS for this option. To modify the standard value, 
edit this option to the following: 


Format: 


QUESIZE EQU n 


Parameter: 
n is a decimal number specifying the maximum 
number of slots for the MTM task queue. The 
maximum value or this option is 200. A 


recommended value for n is NUSERS. 
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2.4.16 OS/32 Accounting Facility (SGN.ACT) Option 


The accounting facility (SGN.ACT) option enables support for the 
OS/32 accounting facility under MTM. The standard MTMPARMS file 
does not support the accounting facility. To enable support for 
the accounting facility and specify the maximum number of device 
and file classes that can be used, edit this option to the 
following: 


Format: 
SGN.ACT EQU n 
Parameters: 


n is a decimal number from 2 through 32 
specifying the maximum number of device and 
file classes to be used by the accounting 
facility. A 0 indicates no accounting 
support. 


Functional Details: 


The value of n should be greater than, or equal to, the number 
specified in the OS/32 accounting configuration statement. A 
minimum value of 2 is required to support indexed and contiguous 
files. 
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2.4.17 Batch Job Pause (SGN.BTCP) Option 


The batch job pause (SGN.BTCP) option allows a batch job running 
under MTM to pause without being cancelled. The standard value 
of this option causes a batch job running under MTM to _ be 
cancelled whenever execution of that job is suspended. To enable 
the batch job pause option, edit this option to the following: 


Format: 
SGN.BTCP EQU 1 
Functional Details: 


The batch job pause option is enabled by equating SQN.BTCP to 1. 
If this option is enabled, a message is output to the system 
console when a batch job pauses. The system operator may then 
take appropriate action. 
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2.4.18 Default User Volume (SGN.MVOL) Option 
The default user volume (SGN.MVOL) option defines the default 
volume for an MTM user. The standard MTMPARMS file defines the 


system volume as the default user volume. To specify a default 
volume, edit this option to the following: 


Format: 


SGN.MVOL EQU C'name' 


Parameters: 
name is the name of a disk volume to be used as the 
default user volume for all users at sign-on 
time. This name must be four characters in 
length. The first character must be 


alphabetic, and the remaining alphanumeric. 
If less than four characters are used, the 
remaining characters must be blanks, e.g., 
C'MTM'. Four blank characters indicate that 
the default user volume is the system volume. 


48-023 FOO RO2 2-27 


2.4.19 Batch Job Relative Priority (SGN.PRIO) Option 
The batch job relative priority (SGN.PRIO) option defines’ the 


relative default priority of a batch job running under MTM. To 
modify the standard value, edit this option to the following: 


Format: 


SGN.PRIO EQU n 


Parameter: 


n is a decimal number from 0 through 20 that is 
added to the MTM default priority (MTMdp) of 
an interactive job to determine the absolute 
priority at which an MTM user's batch job will 


run. For example, the standard value of 6 
indicates that a batch job will run at six 
priorities lower than an interactive job 
unless otherwise specified. If 0 is 


specified, O is added to the MTMdp of an 
interactive job. This indicates that a batch 
job will run at the same priority as an 
interactive job unless otherwise specified. 


Functional Details: 


Default priorities for interactive and batch jobs are calculated 
as follows: 


TYPE OF JOB PRIORITY 

MTM MTM link priority 

Interactive MTMdp = MTM link priority + 12 

Batch MTMdp + SGN.PRIO = MTM link priority + 12 + n 


Once these default priorities are established, any priorities set 
by an MTM user in the SUBMIT command are checked against the 
default priorities. A batch job is always run at the lowest 
possible valid priority and is never run at the same priority as 
MTM. Default priorities for interactive jobs are not affected by 
this option. 
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Example: 


If: 


128 
10 


MTM link priority 
SGN.PRIO 


the following become the MTM default priorities of interactive 
and batch jobs: 


140 
150 


Interactive job 
Batch job 


ios 


As shown in the following examples, priorities specified by an 
MTM user in the SUBMIT command are checked against the default 
priorities established at MTM sysgen. 


Example: 


Assume the following SUBMIT commands are entered by an MTM_ user 
(SGN.PRIO=10): 


SUBMIT TEST.JOB, PR=138 
SUBMIT TEST1.JOB, PR=150 


The priority for TEST.JOB is invalid because the user. specified 
that the submitted job be run at a higher priority than the MTMdp 
of 140. The job will be run at 150. 


The priority for TEST1.JOB is valid because it is lower than the 
MTMdp of 139. 


The batch job TEST1.JOB will be run at the specified priority of 
150. 
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Example: 


Assume the following SUBMIT commands are entered by an MTM user. 
The jobs will be run at either the MTMdp for batch jobs or the 


Link priorities, whichever are lower. (SGN. PRIO=6) 
LINK 
JOB PRIORITY 
SUBMIT TEST.JOB 128 
SUBMIT TEST1.JOB 200 
SUBMIT TEST2.J0B,PRIO=160 180 


TEST.JOB will be run at the batch priority of 140, which is lower 
than the link priority of 128. 


TEST1.JOB will be run at the link priority of 200, which is lower 
than the batch priority of 146. 


TEST2.JOB will be run at the link priority of 180, which is lower 


than both the submit priority of 160 and the batch priority of 
146. 
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2.4.20 Forced Roll (SGN.ROLL) Option 


In most operating system environments, it is desirable to make 
every task running under MTM rollable. With the forced roll 
option (SGN.ROLL) enabled, every task, except executive tasks 
(e-tasks) loaded by MIM, is made rollable at load time. The 
standard MTMPARMS file enables forced roll. To disable forced 
roll, edit this option to the following: 


Format: 


SGN.ROLL EQU 0 


Functional Details: 


This option applies only to the private image segment of the 
task. Shared segments are not rolled. See the OS/32 Application 
Level Manual for a description of the task image segments 
established by Link. 
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2.4.21 Multi-Terminal Monitor (MTM) Scheduling (SGN.SCHR) Option 


The MTM scheduling option (SGN.SCHR) allows the user to. select 
one of three scheduling techniques. The scheduling techniques 
available through SGN.SCHR are OS/32 priority scheduling, dynamic 
priority scheduling, and the MTM priority scheduling mechanism 
(PSM). Dynamic priority scheduling is specified by the standard 
MTMPARMS file. To modify the standard value, edit this option to 
the following: 


Format: 


SGN.SCHR EQU n 


Parameter: 


n may be O, 1, or 2. 


Functional Details: 


When O is selected for n, no special task scheduling is done for 
MTM subtasks. The standard task scheduling of OS/32 is used; 
i.e., tasks are run according to their priority and the timeslice 
value from the SET SLICE command. Tasks of equal priority are 
schedled on a first-in/first-out (FIFO) basis. See the OS/32 
Application Level Programmer Reference Manual for more 
information on OS/32 priority scheduling. 


When 1 is’ selected for n, dynamic priority and timeslice. 
scheduling is activated for MTM subtasks. Through dynamic 
scheduling a task's priority is adjusted through a range of 13 
priorities, while a task's timeslice is adjusted through a range 
from 20 milliseconds to 2 minutes. Computation intensive’ tasks 
(i.e., tasks that consume their timeslice without an interrupt) 
are adjusted to the next lower priority and their timeslice is 
doubled. I/O intensive tasks (i.e., tasks that are interrupted 
before they consume their timeslice) are adjusted to the next 
higher priority and their timeslice is halved. Dynamic 
scheduling of MTM subtasks by OS/32 ensures that tasks which 
require interactive terminal I/O are adjusted to the highest 
allowable priority. 
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When 2 is selected for n, the MTM priority scheduling mechanism 
(PSM) is activated for MTM subtasks. PSM increases system 
throughput by adjusting the priorities of MTM subtasks according 
to ther run-time priorities. PSM performs a periodic check on 
the run-time behavior of all MTM_ subtasks. Based on this 
behavioral information, PSM adjusts the priorities of subtasks 
whose current priorities are in the range of *+12 to *+128, where 
* equals the task priority for .MTM. 


All current subtask priorities outside this range and _ those 
priorities set by the PRIOR command or the SUBMIT command at load 
time are fixed. Fixed priorities cannot be modified by PSM. In 
addition, PSM cannot alter the maximum batch priority set by the 
SGN.PRIO option. Table 2-1 summarizes task priority modification 
when PSM is enabled. 


PSM lowers the task priorities of subtasks requiring a relatively 
large amount of CPU time, while PSM raises the priorities of 
subtasks that perform a large number of I/O operations. PSM will 
not raise a task's priority above the priority set at link time 
(except when the task is rolled). 


All priorities assigned by PSM (except for rolled-out tasks) must 
be within the *+12 to *+128 range. To increase the chances of 
entry into the system, PSM gradually raises the priority of a 
rolled-out subtask to *+1l. However, once the task is’ rolled-in, 
PSM adjusts its priority within the *+12 to *+128 range. 


TABLE 2-2 MODIFICATION OF MTM SUBTASK PRIORITIES WITH 
PSM ENABLED 


I ee re ee ee Ra 


ALLOWABLE PRIORITY 
MODIFICATION 


| DEFAULT TASKS  j; 
| SoS oe SOS REP RS RR SS PR EET CSS SE SR SRE SRS SESS ese Sees | 
Ls {| .MTM {| Fixed priority - cannot 
{ 1 .MTMASST | be modified by PSM. ! 
| .SPL 
a a a a aa a ae a alc el nd aa a 
i * +1 | None Fixed priority range - 
. { can be modified by PRIOR | 
: { command or a SUBMIT 
. {| command issued by a user | 
1 * +11 {| with the privilege to 


alter batch priorities. 
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TABLE 2-2 


MODIFICATION OF MTM SUBTASK PRIORITIES WITH 
PSM ENABLED (Continued) 


ALLOWABLE PRIORITY 


PRIORITY {| DEFAULT TASKS | MODIFICATION 
* +12 All MTM inter- | Subtasks whose priorities 
active tasks lie within this range can 
be modified by PSM accor- 
* +13 All batch MTM ding to their run-time 


* +128 or 248 
(whichever is 
smaller ) 


(whichever is 
smaller ) 


jobs 


behavior priorities for 
all tasks (except rolled- 
out tasks) adjusted by 
PSM must remain within 
this range. 


i 
PSM raises or lowers task | 
priorities for batch jobs | 
as it does for inter- { 
active tasks except PSM 
cannot raise a batch job | 
priority higher than the | 
maximum set at MTM | 
sysgen. (See SGN.PRIO). { 

1 
, 
H 
{ 


NOTE 


Priorities in this range 
that have been set by 

the PRIOR or SUBMIT 
commands are fixed. These 
priorities cannot be 
adjusted by PSM. 


ee ec ee ce a ae me Oe ee ee me ma ee a ae ca a a a a mw ra om cme 


Fixed priority range - can 
be modified by PRIOR 
command only. 


ne ee Me en en ee er ee ee ree en ee ee en ee es eee Bre eee ere ene eC eT ee ee 


See 


the Multi-Terminal Monitor (MTM) Reference Manual for more 
information on the PRIOR command. 
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2.4.22 SPL/32 Interface (SGN.SPL) Option 


The SPL/32 interface (SGN.SPL) option gives MTM users access’ to 
the SPL/32 software. SPL/32 must be configured into the system 
during OS/32 sysgen; otherwise, this option has no affect on the 
system. The standard MTMPARMS file does not enable the SPL/32 
interface. To enable SPL/32 support, and specify the desired 
number of send data buffers, edit this option to the following: 


Format: 


SGN.SPL EQU n 


Parameter 


n is the number of send data buffers. 


Functional Details: 


When 0 is selected for n, SPL/32 support is disabled. If SPL/32 
support is desired, a recommended value for n is NUSERS. 
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2.4.23 Global and Local Variables (SGN.VAR) Option 


The global and local variables (SGN.VAR) option specifies the 
maximum number of global and local variables that an MTM user can 
define. The maximum number specified by the standard MTMPARMS 
file is 28. To modify the standard value, edit this option to 
the following: 


Format: 
SGN.VAR EQU n 
Parameter: 


n is a decimal number from 28 through 1,024 
specifying the combined maximum number of 
global and local variables a user can define. 
If n equals 0, variable support is not 
included in MTM. 
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2.4.24 Number of New Global Variables (SGN. ®@GLO) 

The number of new global variables (SGN.@GLO) option specifies 
the maximum number of new global variables that can be defined by 
an MTM user via the $DEFINE command. The maximum number of new 


global variables specified by the standard MTMPARMS file is 15. 
To modify the standard value, edit this option to the following: 


Format: 


SGN.@GLO EQU n 


Parameter: 


n is a decimal number from 0 through 99 
specifying the maximum number of new global 
variables allowed. 


Functional Details: 


Each new global variable defined by a user occupies one command 
buffer. Therefore the number specified for this option should be 
considered when specifying the NCSBFS option. 
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2.6.25 Number of New Internal Variables (SGN.@INT) Option 


The number of new internal variables (SGN.@INT) option specifies 
the maximum number of new internal variables that can be defined 
in an MTM user's CSS command file via the $DEFINE command. The 
maximum number of new internal variables specified by the 
standard MTMPARMS file is 8. To modify the standard value, edit 
this option to the following: 


Format: 


SGN.@INT EQU n 


Parameter: 


n is a decimal number from 0 through 99 
specifying the maximum number of new internal 
variables allowed in a CSS command file. 


Functional Details: 


Each new internal variable defined by a user occupies one command 
buffer. Therefore the number specified for this option should be 
considered when specifying the NCSBFS option. 
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2.6.26 HASP Interface (SGN.$HSP) Option 


The HASP interface (SGN.$HSP) option allows terminal users’ to 
switch from an MTM time-sharing environment to a HASP 
environment. The standard MTMPARMS file does not enable the HASP 
interface. To enable the HASP interface, edit the SGN.$HSP 
option to the following: 


Format: 
SGN.$HSP EQU n 


Parameters: 


n is a decimal number from 1 through 99 
specifying the maximum number of tasks that 
can be concurrently interfaced with HASP_ by 
MTM users. If n equals O, the HASP interface 
feature is disabled. 
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2.4.27 Central Processing Unit (CPU) Limit Per Account ing 
User Class (UCPULIM) Macro 


The CPU limit (UCPULIM) per accounting user class macro defines 
the maximum CPU time allowed for each accounting user class. 


There is a maximum of 16 accounting user classes (0-15) 
established in the authorized user file (AUF). Each account is 
assigned to one of the established accounting user classes. A 


terminal session or batch job is limited to the CPU time 
designated for the class to which the account belongs. To define 
CPU limits for each user class, first enable the OS/32 accounting 
facility using the SGN.ACT option. Then, enter the UCPULIM macro 
as follows: 


Format: 
[label] UCPULIM limitot,limitob, limit,t, limit,b, 
Limityt, limityb 
Operands: 


Limit,t is a decimal number ranging from O_ through 
86,400 (one day) indicating the maximum number 
of seconds of CPU time allowed any terminal 
session for a user signed on to an account in 


user class n. If lLimitynt equals 0, no CPU 
limit applies to terminal sessions under class 
He 

Limit,b is a decimal number ranging from 0 -. through 


86,400 (one day) indicating the maximum number 
of seconds of CPU time allowed any batch job 
running under an account in user class n. If 
Limitnb equals 0, the default CPU time Limit 
is the limit set by the CPULIMIT option at MTM 
sysgen. 


Functional Details: 


If execution of a task under any account exceeds the CPU Limit 
set for the accounting user class to which the account belongs, 
the task is terminated (end of task code 1200). After 
termination, no other tasks can be loaded under that account, and 
all batch jobs under that account are aborted. 
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Example: 
UCPULIM 30,30,,,40,3600,80, 10800 


In the above example, the CPU limit for both batch jobs” and 
terminal users in accounting user class 0O is 30. seconds. 
Accounting user class 1 has no CPU limit for terminal users; 
batch jobs are restricted by the limit set in CPULIMIT. For user 
class 2, the CPU limit for terminal users is 40 seconds, while 
batch jobs are limited to 1 hour. Class 3 users are limited to 
80 seconds for terminal users and 3 hours for batch jobs. For 
the remaining classes, no CPU limits are set for terminal 
sessions; batch-jobs running under these classes are limited to 
the value set by the CPULIMIT option. 
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2.4.28 Input/Output (1/0) Count Limit Per Accounting User Class 
(UIOLIM) Macro 


The [/O count limit per accounting user class (UIOLIM) macro 
defines the maximum number of I[/0 transfers, within each I/0 
class, allowed for each task run either from a terminal or batch 
stream for a given user class (0-15). To define I/O count limits 
for each user class, first enable the OS/32 accounting facility 
using the SGN.ACT option, and establish 1/0 classes for MIM using 
the IOTAB macro. Then, enter UIOLIM as follows: 


Format: 
[label] UIOLIM (ugioot,...,Ugiont), tastes: ++ ,Ug iOnb) 
(Upiogt,.--.,Uniont),(Upiogb,...,Unionb) 
Surana 
Un iont is a decimal number ranging from 0. through 


1,000,000 indicating the maximum number of I/0 
transfers to the device assigned to I/0 
class n for all interactive tasks run from a 
terminal for user class n. If uUupiopjt for a 
given user class is omitted, or equals 0, the 
I/O count limits specified for each I/O class 
by the IOTAB macro are in effect for that 
class. 


Upiopb is a decimal number ranging from 0O_ through 
1,000,000 indicating the maximum number of I1/0 
transfers to the device assigned to I/0 
class n for all batch jobs for user class n. 
If Unionb for a given user class is omitted, 
or equals 0, the I/O count limits specified 
for each I/0 class by the IOTAB macro are in 
effect for that class. 


Functional Details: 


If a task attempts to exceed an I/O count limit set for the user 
class to which its account belongs, task execution is terminated 
with an end of task code 1210. All outstanding jobs 
corresponding to the I/O count limit exceeded are aborted. . 


Because the I[OTAB macro defines the I/O classes for MTM, the 
IOTAB macro must precede UIOLIM in the MTM parameter file. 
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Interactive I/O counts for all I/O classes must be enclosed in 
parentheses; a comma is then used to separate the interactive I/0 
counts from the batch I/O counts (also enclosed in parentheses) 
for the same user class. Similarly, a comma following the batch 
I/O counts for all I/O classes is used to separate the parameters 
for one user class from those of the next user class. 


The following example is designed to shed some light on the 


format of the UIOLIM macro and its relationship to the IOTAB 
macro. 


IOTAB (0, INDX),(1,CNTG),(2,DEV),(3,SPL),(4, TAPE) 


UIOLIM (00,01,02,03,04),(100,101,102,103,104), U CLS O 
(10,11,12,13,14),, U CLS 1 
(20,21,22,23,24),(120,121,122,123,124), U CLS 2 
(30,31,32,33,34), (130,131,132,133,134) U CLS 3 

I C D 8 T I Cc D Ss T 
N N E P A N N E P A 
DT V L P D T V L P 
X G E X G E 


Qa Ne po” 


TERMINAL BATCH 


Table 2-3 illustrates the I/O count limits set for batch and 
terminal jobs by the above example of UIOLIM. 
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% @ MH 


x 


TABLE 2-3 


ACCOUNT ING 
USER CLASS 


4 
10 H we fT LE H ee; (12 H xe | 13 H xx ft #14 H 
20 ; 120 4; 21 + Ll2L {| 22 i 122 4; 23 ; 123 {| 24 ' 
30 130 )6{|)— (3 i 131 f; 32 i 132 4; 33 i 133 { 34 ' 


TERM. | 


O (INDX) i 1 (CNTG) { 2 (DEV) H 3 (SPL) 


BATCH {| TERM. |; BATCH {| TERM. ; BATCH | TERM. |} 


! 
1 i LOl |} 2 i 102 | 3 1 103 


4 ’ { { 
xx H x H H x H xx H x H 


LEGEND 


no I/O count limit. 


** T/O count limit set by IOTAB macro. 


NOTE 


The actual I/O count limits used in the 
previous example are for illustrative 
purposes only and should not be construed 
as recommended parameters to the UIOLIM 
macro. 


BATCH 


weer reese SSE TEKST OST FCS REST REP TC ECT ERTS EET SOT RSC SEES TRE | TTT Ee TTT eee TR EEE 


EXAMPLE I/O COUNT LIMITS SET BY UIOLIM 


1/O CLASS 


H 4 (TAPE) 


| TERM. 


H 4 


t 
1 


BATCH 


104 


xx 
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2.4.29 Multi-Terminal Monitor  (MTM) Version Identification 
(VERSION) Macro 


The MTM version identification (VERSION) macro assigns an 
identification name or number to the current revision of the MTM 
system. To specify an identification name for an MTMPARMS file, 
edit this option to the following: 


Format: 
[label] VERSION ‘ia! 


Parameter: 


id is a 16-character alphanumeric string 
identifying the current’ revision of the MTM 
system. Special characters are allowed. If 


blanks are used, identification name must be 
enclosed in quotes. 


Example: 


VERSION '3230-B' 
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2.5 MEMORY REQUIREMENTS FOR SYSTEM GENERATION (SYSGEN) OPTIONS 


The MTM sysgen options reside in data structures built within the 
MTM task address space. Table 2-4 lists each data structure and 


its size. 


TABLE 2-4 DATA STRUCTURES 


BUILT BY MTM SYSGEN 


eC een en ee enn en en en ee ee ee ee ee 


H DATA 1 
| STRUCTURE | MEAN ING H 
| HPS eee sees ser See eee Se eS eee SSS eee 
i Sysgen | Contains the sysgen jj; 
| Parameter { parameter values to jj} 
} area i be used by the H 
i | MTMMAIN module i 
i 

( 

Terminal One is built for 


SIZE (IN BYTES) 


128 


"BESS SSS SEES ESS SSS SKS SST STS Te RS KS we 


eT ee RT en eee i Me Me ee i ie ee re i i ee ed 


584+ (NCSSLVS+1) *8 


i] { ! 

' | 1 

; user ; each concurrent MIM ,; +CSBFSZ+4 

i block i user defined by i +SGN.ACT*4+4 

| (TUB) | NUSERS option i 

| cd tcc “cau “Cem: ms mmm eS nm, ms inertia es, ; ed sn i tli thin Si’ sei ia “a ni ie irc ‘a. atest “ei, i ani‘ i tv ns 
; Command ; Contains the eemaina i (3*NUSERS+NCSBFS) * (CSBFSZ+4) 
ij buffer ; buffers H 

' area } i 

H vine te jo: i pe Ga ha ls va mca at asi em, s,m Gt: ge einai ay Ss Ses mS. sco re sans ly pe it ter issih Sn at: Snew Shar p uch e_Se e anl  oe ms cd 
| Special i Contains the pool of | NCONBFS* (CONBFSZ+4) 

i} console | special console H 

i; buffers |; buffers H 

i a a a lantern ys nae, Se mr sas ap ts, ae, aa eg oS Se tm jes Ys Sc {iis SS oii ws amas sl “an in pe: Sa i “enn ede am, tn, 
i Message Contains the message ; 76*NMSGS 

i buffer | buffers i 

} area H i 

H sg cn 1a “esc mp * Yb S-Ni, a nS ss (Gu ay i Si a Sai) Sl ‘Si na a Sc’ i'n e's Samm’ ms pn) Sa as “sa “Shs yas "a owe ni wend <a 
} Sector i Containa the sector j (256*CDBUFSIZ+256) *NSECTS 

| buffer i buffers H 

; area H H 

H mi ms iii eh ce pom ip» a's agp i mh mi jm ou cay Gl Sy Ge mi sip <1), Sim, mp Ss” mS," ‘ng “mil spn mc mh pl“ mn. i’ mle ith ive a ag ul 
i Circular { Contains the MTM | 4*QUESIZE+8 

i List ;} task queue H 

{ area l H i 

i hs “a i nn a Cin lh aie, Tp al A op? cll ee? ain svi’ du ui ui ang ia’ mc mst sil ‘as: ie wa iene i, 
Circular Command buffer wait {| 4*NUSERS+8 

; List | queue H 

} area 2 H i 

i ‘a Spates Gis be dns Ti. Spa es St, e-waste. ‘sg i Sg. Siam: an: ‘t,o, esi ei. i ina, el, 
i Circular Gonesve buffer wait ; 4*NUSERS+8 

; List ;} queue H 

; area 3 i H 

H Si el wn an i tt, i sl ai aa. i ot “la td ii: ih‘: mh. esi in. “ci. si psig: a in: i a i lei ma st <a i i li i Sl. in ee “as 
i; Circular | Sector buffer wait H 4*NUSERS+8 

; List } Queue i 

; area 4 H i 
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TABLE 2-4 DATA STRUCTURES BUILT BY MTM SYSGEN (Continued) 


Cee een en ee ee ee ee ee ee ee) 


1 DATA H { 
} STRUCTURE } MEAN ING H SIZE (IN BYTES) 
H SVs SeETset Ss SS SF RTS KC SSI VTAS KS SSK STK SS SKE SVS SS SK KS KS SSS SKM SF SSS LS SS ST SSIS SSS SST ST STS 
; Circular ; lu wait queue i 4*NUSERS+8 
; List H } 
} area 5 H j 
Pao sete eee Se eee eee ees eee ee eee een ae eee eee eee 
H Cireuiae | Message BOE rex: pace | 4*NMSGS+8 
; List {} queue H 
} area 6 H H 
i “cn mi ce op’ ib Tm “ns <a wiih ee en wa: le, Som: Sn in ta" i: a nui mane itm ps7 ag Sn: sun Sai’ me“ ln, i Zk coin \ Ga suc nen “vrei Sem “aes Tne Ue vi. os 
} Recount ina! Used by MTM to write ;} 128 or BeclasseseBa 
} write ; accounting informa- ; (whichever is larger) 
;} buffer } tion to the account- |} 
{ } ing transaction file } 
| (ATF) 
} som ch, al’ mek Ws ta,“ ci a nme eS mises, ti“ Rom mi Sic i ta ui sin ie, Sm ei ais “as i“ noms cn ama cen amsen ew aS Gime No 
; Command | Used fe AeeunhGiste H (3*NUSERS+NCSBFS) *4 
|} buffer } command buffer usage }; 
} usage i for .MTM STATUS,USED ; 
i | eommane i 
| inet ie) toe tum ie nm lta re tins Soe, cls Sen’ i> Samm Spm’ Sm pm mm im: i’ ‘bem cn Sau’ Sa" Gb Sg Sumy ames "en, 66055 Dm Sins nm’ emesis ep sarah cos las) sph sinh / ears Spice” tym eto 
; I/0 e1awe H Gonbaina the 1/0 H 8*SCN. ACT 
} table | accounting class H 
H i} name and limits. H 
i ; This table is built } 
{ i by the IOTAB macro i 
} Ea dl ibs rei’ hmm: i Su sn G0NSG nial ni ice “sr oes uc smd pe cam cn Sew em ns sone kei sew“ Sp’ sap, emia ag Sees Sasa lc hw Sp an Ys 
; CPU Limit |} Contains the CPU i 128 
| table | limits for terminals };| 
H } and batch jobs for H 
H ; each user class. H 
H | Built by the UCPULIM ; 
H } macro i 
(epee dia aay eer a a ee tee ee ee ee ee 
i I/O Limit i Contains the I/O i} 128*SGN.ACT 
| table } Limits for terminals };| 
H } and batch jobs for H 
H ;} each I/O class by | 
j j user class. Built i 
i | by the UIOLIM macro jj} 
eee eer ee tee age Spe ep ere ee eee 
SPL/32 Contains the mnemon- 260*SGN. SPL+532 
send data ic table, send data 
buffers 


used by MTM and 
SPL/32 


Pe Nee reenact te eal etinedinetmlinedd 


' ! 
J ' 
| buffer queue, and, H 
} send data buffers H 
{ t 
U ’ 
' 
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CHAPTER 3 
AUTHORIZED USER UTILITY 


a 


3.1 INTRODUCTION 


Prior to loading and starting the multi-terminal monitor (MTM), 
an installation must establish valid account numbers’ and 
passwords for its authorized users. This is accomplished through 
the authorized user utility supplied with the MTM software 
package. The authorized user utility maintains a file containing 
information on each account number. This file is called the 
authorized user file (AUF). 


3.2 AUTHORIZED USER FILE (AUF) 


The AUF contains one record for each account. An account number, 
group number, and password are required for each account. In 
addition, a user identification, limits for signon and CPU time, 
and privileges for each account may be optionally specified in 
the AUF. Defaults are set by the utility for all optional 
information not specified by the installation. The record format 
for the AUF is shown in Figure 3-1. 
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RESERVED 
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Figure 3-1 Authorized User File Record Format 
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The authorized user utility is used to create, update, and report 
on the AUF. 


Initially, the utility should be run from the system console _ to 
create an AUF. In order to enable access under MTM, the AUF must 
be renamed to account 255. 


Example: 
RENAME USERS.AUF,USERS .AUF/255 


Once the AUF is renamed to account 255, it can be updated while 


MTM is running by signing on to account 255 and running the 
utility. 


When the AUF is assigned to account number 255, it is protected 
in two ways: 


@ only users signed-on to account number 255 can access the AUF, 
~ and 


e the authorized user utility does not display the password to 
account 255 ina listing. 


When the LIST command of the authorized user utility is entered, 
the account number, group account number, user identifier 
(userid), signon time remaining, CPU time remaining, account 
privileges, and date are displayed. Once added to an account 
record, the password cannot be retrieved from the AUF, but can be 
changed by the CHANGE command. 


Accounting limits and privileges can be specified for each 
account number through the following AUF commands: 


e ADD command (create or update mode) when adding a new account 
to the AUF, or 

e@ CHANGE command (update mode) when making changes to an already 
existing account. 


Two resources can be limited by account number: 


e Signon time 


@e CPU time 
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Signon time can be limited for each account by specifying the 
maximum time the total number of terminal users assigned to that 
account can be signed on to the system. Whenever a terminal user 
signs off the system, these limits are checked. If the terminal 
user has used all of the remaining signon time specified for that 
account, or tries to sign on to an account with no signon time 
left, the signon request is rejected and this message is 
displayed: 


NO TIME LEFT 


CPU time can be limited for each account by specifying the 
maximum time the total number of terminal users assigned to that 
account can use the CPU. Whenever a terminal user's’ task 
terminates, these limits are checked. If the terminal user has 
used all of the remaining CPU time specified for that account, 
this message is displayed: 


YOUR CPU TIME HAS EXPIRED 


If a terminal user tries to load a task assigned to an account 
with no CPU time left, this message is displayed: 


TIME-ERR 


3.3 BUILDING AND STARTING THE AUTHORIZED USER UTILITY 


The authorized user utility supplied with the package has been 
Linked according to the sequence of Link commands shown below. 
User involvement is only necessary when additional Link options 
are required. In that case, the user must specify the necessary 
option and re-link the task. See the OS/32 Link Reference 
Manual. 


L .BG,LINK 
T .BG 
st 


TITLE ACTUTY 
ESTABLISH TASK 
MAP ,ADDR 

INCL ACTUTY .OBJ 
BUILD ACTUTY 
END 
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The following starts the authorized user utility. 


Format: 
CREATE 
COMMAND 
START, =fd, ,-LIST=fd>2 ,< UPDATE =fd3 [,ACCOUNTS=n | 
CMD 
REPORT 
Parameters: 

CMD= fd, indicates the device or file from _ which 
command input will come. The authorized user 
utility assigns the command input device to 
logical unit 1 (lul). 

LIST= fdo indicates the device or file to which the 
output is sent. The authorized user utility 
assigns the list device to lu3. 

CREATE specifies a mode of operation for the utility. 

UPDATE= The AUF to be created, updated, or about which 

REPORT a report is needed, is specified by fd3. The 
authorized user utility assigns the specified 
AUF to lu3. 

ACCOUNTS=n n is a decimal number (0-65,535) indicating 

; the maximum number of accounts allowed in the 
AUF file specified by fd3. In the CREATE 
mode, n indicates the size of the new AUF. In 
the UPDATE mode, n indicates the size to which 
the AUF is to be extended. If the ACCOUNTS 


parameter is not specified, the maximum number 
of accounts in the AUF defaults to 255 or the 
maximum set by a previous ACCOUNT command. 
This parameter is ignored when AUF is 
operating in the REPORT mode. 


Functional Details: 


When the CREATE mode is selected, the authorized user utility 
allocates, assigns, and initializes the new file specified by 
fd3. If the file specified by fd3 already exists, an error 
message is generated and the authorized user utility goes to end 
of task. If the UPDATE mode is selected, an update to the file 
specified by fd3 is requested. If the REPORT mode is selected, 
a report of the file specified by fd3 is requested. If the 
specified file does not exist for the UPDATE and REPORT modes, an 
error message is generated, and the utility goes to end of task. 


The authorized user utility assigns all logical units based on 
the parameters specified in the START command. These starting 
parameters can be entered in any order. The user cannot assign 
specific logical units. 
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Examples: 


The following example creates an AUF named NEWFILE. The system 
console (CON:) is the command input device and the line printer 
(PR:) is the list device. Until the START command is issued, 
the file (NEWFILE) does not exist. The authorized user utility 
allocates, assigns, and initializes the new file for accounts 1 
to 511. 


START, CMD=CON: , LIST=PR: , CR=NEWF ILE, AC#=511 
ST By CR= XX CWEXT) CMP =C0N?, LE =COM!) AC= xX K 


The following example specifies the console (CON:) as both the 
command input device and the list device. The mode of operation 
is UPDATE an existing file called AUFILE. 


START, UP=AUF ILE, CMD=CON: , LIST=CON: 


3.4 AUTHORIZED USER UTILITY COMMANDS 


The authorized user utility commands are: 


e ACCOUNTS 


e ADD 

e CHANGE 
e DELETE 
e END 

-e LIST 

e MODE 

e@ PAUSE 


e@ PRIVILEGE 


e TOTAL 


The utility has three modes of operation: 


e@ CREATE 
@ REPORT 
@ UPDATE 
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Each mode allows certain authorized user utility commands’ to _ be 
executed. See Table 3-1. 


The create mode is used to establish a new AUF. 
The report mode allows an account record to be listed or an 
accounting report for each active account (an account record 


already assigned whether used or not) to be generated. 


The update mode allows account records to be added, deleted, 
modified, or listed. 


TABLE 3-1 AUTHORIZED USER UTILITY 
MODES AND ALLOWANCE 


COMMANDS 
ee ae MODES ! 
| COMMANDS | CREATE | REPORT | UPDATE | 
ACCOUNTS {| * {| ** | * | 
oe ee 
isc nee NS , 
| CHANGE x i H * | 
| DELETE «| * | | * | 
fe ee rr 
lc eee nO enero eee a | 
| LIST i - i * H ~ | 
;MODE ot * GE 
| PAUSE =} 0 * tO G 
| PRIVILEGE | * | ** G0 ® 
(TOTAL =} EE ! 
LEGEND 


* Command can be executed in 
specified mode 


*xk Display (no operand) form only 


48-023 FOO RO2 ' 37 


3.4.1 ACCOUNTS Command 


The ACCOUNTS command raises or lowers the account number limit 
for the AUF file. This command also displays the current limit 
set for the file. 


Format: 
ACCOUNTS n 
Parameters: 


n is a decimal number from 1 to 65,535 indicat- 
ing the account number limit of the AUF. If 
n is omitted, the current account number limit 
is displayed. If the value specified for n is 
illegal, the ACCOUNTS command is ignored. 


Functional Details: 


In the REPORT mode, this command can be used in display form 
only. The authorized user utility sets the account limit in 
blocks of 256 records - one account per record. If mn does not 
specify the last record in a 256 record block (e.g., 255, 1023, 
etc.), the value of n is raised to the next multiple of 256. For 
example, if n=100, the account limit is set to 255. 


After the ACCOUNTS command is executed, the following message _ is 
sent to the console: 


ACCOUNT LIMIT = n 


The variable n is the current maximum account number to which the 
AUF has been raised or lowered. If the ACCOUNTS command is 
entered without a value specified for n, this message will 
display the current account number limit in the AUF. 
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Examples: 


ACCOUNT 
ACCOUNT LIMIT = 2047 
ACC 1000 
ACCOUNT LIMIT = 1023 
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3.4.2 ADD Command 


The ADD command establishes an account to the AUF. 


Format: 


‘signontime 
ADD actno,groupno, password, [userid] r ' 
* 


cPut - 


* 


[, privileges] 


Parameters: 


actno 


groupno 


password 


userid 


signont ime 


CPUt ime 


is a decimal number from 1 through the current 
account limit specifying the account number to 
be established. 


is a decimal number from 1 through the current 
limit (except 255) specifying a group 9 account 
number to which the private account number is 
to be assigned. Group number 255 is valid 
only as a group number for account 255. 


is a l- to 12-character alphanumeric string 
specifying the password to be established for 
the account. 


is a l- to 20-character alphanumeric string 
specifying the account user's identification. 


is a decimal number specifying the number of 


seconds of signon time to which the account is 


Limited. If an asterisk (*) is specified, no 
limit is applied. For convenience, this 
parameter may be entered in any of the 
following formats: hh:mm:ss, mm:ss, or 


seconds; for example, 1:30:10, 90:10, and 5410 
all represent the same limit. 


is a decimal number specifying the CPU time to 
which the account user is’ Limited. If this 
parameter is omitted, the default established 
at MTM system generation (sysgen) is used. If 
an asterisk (*) is specified, no limit is 
applied. This parameter may be entered in the 
same formats as signontime. 
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privileges is a hexadecimal number specifying the 
privileges to be allowed for users signed on 
under this account. If this parameter is not 
specified, the default privileges O000A800 
(RENAME, ENVIRONMENT AT SIGNON, and PRIVATE 
CSS EXECUTION) are assigned to the account. 
See Section 3.4.9 for information on account 
privileges and their corresponding hexadecimal 
codes. 


Functional Details: 


This command cannot be used in REPORT mode. The account added to 
the AUF must be inactive. If the account number is active, an 
error message is generated and the existing record is not 
changed. The utility mode must be CREATE or UPDATE. A _ copy of 
the record is written to the log device. 


Account 255 must be added when the AUF is first created. A 
warning results if account number 255 does not exist when the 
utility is terminated. 


The privileges for account 255 are set to FFFFBFFF regardless of 
the privileges specified when account 255 is established. 


Example: 


The following ADD command adds account number 1000; the group 
number is 250; the password is RAY; the userid is DEPT 2; the 
signon time limit is 9999:59:59; no CPU time limit is set; the 
privileges in effect are SVC6 COMMUNICATION, CHANGE PASSWORD, 
PRIVATE CSS EXECUTION, TEMPORARY and SPOOL FILES, ENVIRONMENT AT 
SIGNON, and RENAME. 


ADD 1000,250,RAY,DEPT 2,9999:59:59,*, 8000F800 
1000 250 DEPT 2 9999:59:59 al 8000F800 03/03/83 
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3.4.3 CHANGE Command 


The CHANGE command changes fields in the AUF record of an active 


account. 


Format: 


CHANGE actno, (groupno] , [password] , [user id] | 


: 


Parameters: 


actno 


groupno 


password 


userid 


signont ime 


CPUt ime 


x 


= 


x 


((privileges] 


is a decimal number from 1 through the current 
account limit specifying the account number to 
be changed. 


is a decimal number from 1 through the current 
account limit (except 255) specifying the 
group number to which the account is to be 
assigned. Group number 255 is valid as a 
group number for account 255. 


is a l- to 12-character alphanumeric string 
specifying the password for the account. 


is a l- to 20-character alphanumeric string 
specifying the user's identification for the 
account. 


is a decimal number specifying the additional 
signon time to which a terminal user is 


limited. If an asterisk (*) is specified, the 
currently established limit is changed and no 
Limit is applied. For convenience, this 
parameter may be entered in any of the 
following formats: hh:mm:ss, mm:ss, Or 


seconds; for example, 1:30:10, 90:10, and 5410 
all represent the same limit. 
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CPUt ime is a decimal number specifying the additional 
CPU time to which the terminal user is 
limited. If an asterisk (*) is specified, the 
currently established limit is changed and no 
limit is applied. This parameter may be 
entered in the same format as signontime. 


privileges is a hexadecimal number specifying the 
privileges to be allowed for users signed on 
under this account. See Section 3.4.9 for 


information on the account privileges’ and 
their corresponding hexadecimal codes. The 
privileges for account 255 default to FFFF 
BFFF. 


Functional Details: 


This command cannot be used in REPORT mode. As each record is 
changed, a copy of the original and resultant record is sent to 
the list device. 


The values of signontime and CPU time are added to the current 
signontime and CPU time limits in the AUF to increase the time 
allocations. To decrease the time allocation, precede signontime 
or CPU time with a minus sign (-). An asterisk (*) causes’ the 
limit to be disabled. 


Example: 


The following CHANGE command changes the CPU time limit for 
account number 1000 from unlimited CPU time to a limit of 
1:30:10. 


CH 1000,,,,,5410 
1000 250 DEPT 2 9999:59:59 aie 8000F800 03/03/83 
1000 250 DEPT 2 9999:59:59 1:30:10 8000F800 03/03/83 
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3.4.4 DELETE Command 


The DELETE command makes an active account inactive. 
Format: 
DELETE actno 


Parameter: 


actno is a decimal number from 1 through the current 
account limit (except 255) specifying the 
account number to be made inactive. 


Functional Details: 


This command cannot be used in REPORT mode. A copy of the 
deleted record is written to the list device. 


Examples: 


The following DELETE command deletes account number 207. 


DEL 207 
207 205 308503154TEMP SHOBER** =, A800 02/18/83 


The following command attempts to delete an inactive file. 


DEL 207 
x** ACCOUNT NUMBER 207 WAS INACTIVE 
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3.4.5 END Command 
The END command closes all logical units and terminates’ the 
utility. 
Format: 
END 


Functional Details: 


If the utility is ended and account 255 does not exist, the 
utility issues a warning that the user has created an AUF that 
cannot be accessed later. 


Example: 


END 
** WARNING ACCOUNT 255 DOES NOT EXIST 
LAURIE -END OF TASK CODE= 0 CPUTIME=1.463/2.450 
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3.4.6 LIST Command 


The LIST command displays active account records to the list 
device. 


Format: 
List|actno, [actno, J] 
Parameters: 


actno, is a decimal number from 1 through the current 
account limit specifying the account numbers 
to be displayed to the list device. If 
specified with actno,, it specifies the 
beginning of a range of account numbers to be 
displayed to the list device. 


actno, is a decimal number from 1 through the current 
account limit specifying the end of a range of 
account numbers to be displayed to the list 
device. 


Functional Details: 


When no account number is specified, all active accounts) are 
listed. When only actno; is specified, only actno; is listed. 
When two account numbers are specified, all account numbers’ from 
the first account number to the second account number are listed. 


Examples: 


In the following example, a single account is listed. 


LIST 1000 
ACT GRP NAME TIME LEFT CPU LEFT PRIV DATE 
1000 250 DEPT 2 9999:59:59 ead 8000F800 03/03/83 
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In the following example a range of accounts is listed. 


LIST 200,1000 
ACT GRP NAME 
201 205 308503154TEMP SHOBER 
207 205 308503154TEMP SHOBER 
211 205 308503154TEMP SHOBER 
230 230 035713087CAROL CARCH 
250 DEPT 2 
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TIME LEFT 


“x 
xx* 
xX 
xx 


9999:59:59 


CPU LEFT 


xx 
xx 
xx 
xx 


1:30:10 


PRIV 
0000A800 
O0O00A800 
0000A800 
0o00A800 
8000F800 


DATE 
02/18/83 
02/18/83 
02/18/83 
02/18/83 
03/03/83 


3.4.7 MODE Command 


The MODE command displays the current mode, changes the current 
mode of the utility, or reassigns or creates an AUF. 


Format: 


CREATE 
Mone |< uppDATE> | [=£ds | 


REPORT 
Functional Details: 


The MODE command, with no parameters, displays the current mode. 
When a mode is specified, the mode is reassigned but the AUF is 
not changed. When fd3 is specified, the mode is changed and the 
AUF is reassigned. 

When the create mode is specified, an error message is generated 
if fd, exists. The authorized user utility allocates the new AUF 


and initializes it for the number of account records currently in 
effect. 


Examples: 

To place the utility in the REPORT mode: 
>»MODE REPORT 

To display the current mode: 


>»M 
ealal REPORT IS THE CURRENT MODE 
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3.4.8 PAUSE Command 


The PAUSE command pauses the utility and transfers control to the 
operating system. If the utility is running under MTM,- control 
is transferred to MTM. The CONTINUE command returns control to 
the utility. 


Format: 


PAUSE 
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| PRIVILEGE | 


3.4.9 PRIVILEGE Command 


The PRIVILEGE command can be used to change or display the 
privileges for an account or range of accounts. 
Format: 
privilege 
PRIVILEGE | actno; [-actnog] |, 
* 

Parameters: 

actno, is a decimal number from 1 through the current 


account limit, specifying the account number, 
or the start of a range of account numbers, of 
which the current privileges are to be changed 
or displayed. If this parameter is omitted, 
the default is all currently active accounts. 


specifying the 


range to be 


actno,z is a decimal number, from (actno, + 1) through 
the current account limit, 
final account number of the 
changed or displayed. 

privilege is the hexadecimal mask of the 


privileges to 


be assigned to the specified account or range 
of accounts. If * is specified, 


privilege OOOOA800 is used. 


the default 


If this parameter 


is omitted, the current privileges of the 


specified account or range 
displayed. 


of 


accounts) are 
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0400 0000 


0080 0000 


0040 0000 


0008 0000 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES 


i I I ed 


SVC6 COMMUNICATION allows the user to load 
a task with task communication enabled. If 
a user without this privilege loads a task 
with the SVC6 communication option, MTM 
disables the option when the task is loaded. 


ETASK allows the user to load executive 
tasks (e-tasks). If a user without this 
privilege attempts to load an e-task, an 
error message is generated and the task is 
not loaded. 


SVC6 CONTROL allows a user to load tasks 
with SVC6 control enabled. At load time, 
MTM checks the task's requested options 
against the user's privileges. If MTM dis- 
covers that the user does not have the SVC6 
control privilege requested by the task, MTM 
disables the option at load time. 


EXTENDED ACCOUNT ACCESS allows the user to 
enter an account number, in addition toa 
class, in an fd. This extended access is 
allowed for the commands RENAME, ASSIGN, and 
LOAD, and for CSS calls. File access is 
Limited to SRO for accounts other than the 
user's private account. Without this privi- 
lege, a user may only enter file classes in 
an fd; i.e., P, G, S. 


SET GROUP allows the user to change the 
group account number of his account via the 
SET GROUP command. If a user without this 
privilege attempts to use the SET GROUP 
command, an error message is generated. The 
user's new group account number is retained 
until signoff or until changed by another 
SET GROUP command. The user's group number 
is not changed in the AUF. No user may set 
his group account to eee 


TASK ACCOUNT PRIVILEGE allows the user — 
load tasks with the account privilege task 
option enabled. If a user without this 
privilege attempts to load a task requesting 
this option, MTM disables the option. 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 


BARE DISK ACCESS allows the user to access 
bare disks for tasks which have this option 
enabled. User's requesting the bare disk 
option without this privilege will have the 
Seas disabled ey. MTM . 


UNIVERSAL TASKS allows the user to run tasks 
as universal tasks. If a user without this 
privilege attempts to run a task with the 
universal option enabled, MTM disables the 
option and th task is run as a user-task (u- 
task). 


ENVIRONMENT AT SIGNON permits the use of the 
ENV= parameter of the signon command. If a 
user without this privilege attempts to use 
the ENV= parameter, MTM ignores the environ- 
ment request and forces the USERINIT.CSS to 
be executed. 


TEMPORARY and SPOOL FILES permit a user to 
display the filenames of temporary and spool 
files. If a user without this privilege 
attempts to display temporary or spool file 
fds, MTM returns *TEMPFILE* and *SPOOLFILE*, 
respectively. 


PRIVATE CSS EXECUTION permits a user to 
execute private CSS files. A user without 
this privilege is limited to system CSS 
calls. 


CHANGE PASSWORD permits a user to select a 
new password via the PASSWORD command. The 
new password is entered in the AUF and re- 
mains in effect until changed by another 
PASSWORD command or the authorized user 
utility. An error message is generated for 
user's without this privilege attempting to 
use the pee One command 


RENAME periite a user to rename private 
files to group or system files; i.e., G, S. 
If a user also has the EXTENDED ACCOUNT 
ACCESS privilege, private files may be re- 
named to any account. Users without this 
privilege may rename files only within their 
private accounts. 


BIT 


13 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 


I ec ie i Be ee re ee eel en ee oe ee a a ee a a 


HEX MASK |} PRIVILEGE AND DESCRIPTION | BIT 
0000 0400 PRIORITIES 1 to ll permit a user to employ } 21 


} the PRIOR command, in a private CSS, to set |} 
{} a task's priority within the range of .MTM+tl | 
{} .MTM+11. The maximum priority available to | 
} users without this privilege is .MTMtl12. 
{ Priorities .MTM+l to .MTM+t1ll are always 
| available to system CSS calls regardless of |} 
; a user's BE ty Ueges: H 
“0000 0200 | BATCH PRIORITY a owe: a user “ES raise cone H 
} priority of a batch job above the default H 
{ priority. The default priority for batch H 
| tasks is .MTM+t2+SGN.BPR1. Batch priorities /} 
| can be raised through the use of the SUBMIT } 
{ and PRIOR commands. The priority of a batch | 
{| task can never be raised above the priority | 
| of interactive tasks (.MTMt12). Users may H 
{ lower batch priorities regardless of their H 

| privileges. H 
0000 0100 PRIVILEGED USER (UNLIMITED FILE ACCESS) H 
allows a user unlimited access to all i 
accounts (except 255). Users with this H 
privilege may enter the SET PRIVATE command } 
to change their account numbers. This H 
allows users to access the files of any H 
account as if they were the users' private 1 
files; knowledge of the account's password 
is unnecessary. This privilege also allows | 
users to change their group account numbers. | 
The user retains all privileges when moving } 
{ 
. 
| 
\ 


to which a privileged user changes are 
ignored. 


This privilege also provides the user with 
the ability to display all batch jobs within 
an account through the INQUIRE command. 
Through the DISPLAY FILES command entered 
with an * in the account field, a user can 
display account numbers rather than account 


i 
} among accounts; the pivileges of the account 
i 
| classes in fds. 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 


{ HEX MASK  } PRIVILEGE AND DESCRIPTION : BIT 
0000 0080 | FOREGROUND INTERFACE allows the use Se the 24 
| $FOREGROUND interface. If a user without H 
i this privilege attempts to connect toa H 
| foreground task, an error message is H 
| generated. H 
0000 0040 ; HASP INTERFACE iiowe tiie: user to ipeerracs 
| with HASP tasks in the system. SGN.$HSP H 
| must be enabled at MTM sysgen to permit this | 
| priority. A user without this privilege who | 
{| attempts to connect with a HASP task i 
| receives an error message. 
0000 O00F | ACCOUNTING USER CLASSES is used is species H 
| an accounting user's class for each account. | 
i There are fifteen (O-F) possible accounting | 
} user classes. Each account must be assigned } 
i to an accounting user class. Each account- ; 
i ing class corresponds to a set of CPU and H 
| [I/O limits as specified by the UCPULIM and H 
( ' 
| : 
i 


ee we ee we we we we we we ww Se Se we 


UIOLIM macros at MTM sysgen. If limits for 
each class are not established through 
UCPULIM and UIOLIM, the limits set by 
CPULIMIT and IOTAB apply, and all accounts 
effectively belong to one accounting user 
class. 


Examples: 


In the following example, the privileges of a single account are 
listed. 


PRIV 1000 
ACT GRP NAME PRIV 
1000 250 DEPT 2 8000F800 
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In the following example, the privileges of a range 
are listed: 


PRIV 200-1000, * 


ACT GRP NAME PRIV 

201 205 308503154TEMP SHOBER A800 
211 205 308503154TEMP SHOBER A800 
230 230 035713087CAROL CARCH A800 
1000 250 DEPT 2 A800 


In the following example, the privileges of an 
changed. 


PRIV 1000,FFFFFFFF 
ACT NAME PRIV 
1000 DEPT 2 FFFFFFFF 
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of accounts 


account 


are 


3.4.10 TOTAL Command 


The TOTAL command generates a report to the list device or resets 
the values in the signontime used and CPU time used fields to QO. 


Format: 
Tora. (c ] 
Parameter: 


Cc is an alphabetic character specifying that the 
signontime used and CPU time used fields are 
to be cleared or reset to O and no report is 
to be generated to the list device. If this 
parameter is omitted, a report is generated to 
the list device and ne values are cleared or 
reset to 0. 


Functional Details: 


The generated report lists each active account. The following 
details concerning each account are displayed: account number, 
group number, signon time left, CPU time left, and the time used 


since the last report was generated. 
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Example: 


58 


GRP NAME 


1035213065DCF GROUP 
18030503089DC CONSULTA 
1035213065CHUCK PECK 
18031183089B0B DOMITZ 
18031183089WILL ETZ 
200357030850S32MT GROU 
103521306S5CHRIS ARCHE 
180362430870S53 
18030493086N SHKOLNIKO 
20032453088ADMINISTRAT 
18032373086RANDEE HAFT 
20031543085PETE HORN 
1035203065JOHN GRAY 
96036243087LANCE PATTI 
18031203089SUE SELBY 
1035203065BILL DEIBLE 
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TIME LEFT 


xx 
xx 
xx 
xx 
xx 
ax 
ax 
xx 
“xx 
ax 
xx 
xx 
xx 
ux 
xx 
xx 


CPU LEFT 


x* 
xx 
xx 
xx 
ax 
xx 
xx 
xx 
xx 
x* 
Kx 
xx 
xx 
xx 
ax 
“x 


PRIV 


0000A800 
0000A800 
8000FCOF 
8000FCOF 
8000FCOF 
8COEFEOF 
8000FCOF 
FFFFFFFF 
8000FCOF 
8CDEFEOF 
8000FCOF 
8000FCOF 
8000FCOF 
8008FCOF 
8000FCOF 
8000FCOF 


TIME USED 


oO 
© 
oO 


Ooo0o000ONnNo0000o uo 


CPU USED 


0:00:00 
0:00:00 
0:00:00 
3:03:59 
0:00:00 
0:00:00 
0:00:00 
0:00:00 
0:00:00 
1:23:49 
0:00:00 
:00:00 
:00:00 
2:00:00 
:00:00 
:00:00 


ooo0coe 


CHAPTER 4 
08/32 ACCOUNTING FACILITY 


4.1 INTRODUCTION 


The OS/32 Accounting Facility is a software feature that is 
optionally specified at OS/32 system generation (sysgen). This 
facility provides the user with management information for 
computer center operation. Information is collected on the basis 
of account numbers and user identifiers (userids), and is 
reported as a formatted summary on user selected account numbers 
and time periods. The collected information includes such items 
as central processing unit (CPU) time, size of a task's segments, 
elapsed time, roll time, wait time, input/output (1/0) counts’ to 
I/O devices, and system space usage. Because data collection is 
performed by the operating system and the multi-terminal monitor 
(MTM), an operating system and MTM sysgen are required and should 
be consistent for both. 


The accounting facility is composed of two parts: 


e Data collection 

@e Reporting utility 

Data collection is performed by the operating system and MTM 
through counting, collecting, and logging routines, which 
together collect and store the accounting information in a_ user 
specified disk file called the accounting transaction file (ATF). 
The reporting utility is a utility program that selects’ and 
transfers accounting information to a printer, disk file or tape 
file. Through operator specified commands, accounting 
information can be used to produce cost distribution, billing, 
control, and information reports. See the OS/32 Systems Support 
Utilities Reference Manual. 

4.2 SYSTEM REQUIREMENTS 


The accounting facility requires these system components: 


e Perkin-Elmer 32-bit processor 


e 256kb memory 
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@ operating system RO5 or higher 

@® accounting support at OS/32 sysgen 
@ accounting support at MTM sysgen 

e disk device 

@ print device 


e temporary files 


4.2.1 O0OS/32 System Generation (Sysgen) 


The accounting facility is included in the operating system by 
specifying the sysgen ACCOUNTING and IOCLASS configuration input 
commands. See the OS/32 System Generation (SYSGEN/32) Reference 
Manual. 


4.2.2 Multi-Terminal Monitor (MTM) System Generation (Sysgen) 


The accounting facility is included in MTM through the parameter 
specified for the OS/32 accounting facility option (SGN.ACT) at 
MTM sysgen as described in Chapter 2. 


4.2.3 Accounting Transaction File (ATF) 


The ATF contains records for all activities performed by each 
account. The information processed by the reporting utility is 
provided by the ATF. The ATF is created by MTM through the ATF= 
parameter of the MTM START command. See Chapter 5. The ATF can 
also be changed by MTM through a parameter in the .MTM operator 
command. When the command .MTM ATF fd is entered, the current 
ATF is closed and a new ATF is’ opened. This allows data 
collection to continue on the new ATF while the reporting utility 
processes the accounting data in the old ATF. If a new ATF is 
not opened, an assignment error is displayed and data can no 
longer be collected. 


4.3 LINK OPTION 


Accounting support can be enabled or disabled for tasks through 
an optional parameter in the LINK OPTION command. See the 0S/32 
Link Reference Manual. 
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4.4 STARTING DATA COLLECTION 


After OS and MTM sysgens with accounting support have been 
performed, MIM is started as described in Sections 5.2 and 5.3. 
Data collection is started by specifying the ATF= parameter of 
MTM START command. 


4.5 DATA COLLECTION 
The OS/32 accounting facility collects data for each account. 


All collected data is stored in the appropriate ATF records’ on 
the basis of a job or task. Job related data is collected on the 
total number of tasks submitted as one job. Task related data is 
collected on a single task. 


Job and task related data are collected and stored in specific 
categories which are explained in the following sections. 


See Appendix D for ATF record formats. 


4.5.1 Accounting Date and Time Formats 


Accounting dates are specified and displayed by MTM in these 
formats: 


e mm/dd/yy is the month, day, and year displayed on the 
terminal user's console when the terminal user 
signs off the system. 


e mon/dd/yy is the month (3 characters), day, and year 
specified in the reporting utility SELECT, 
OPTION, and REPORT commands. See the 0OS/32 
Systems Support Utilities Reference Manual. 


e dd/mon/yy is the day, month (at least 3 alphabetic 
characters), and year specified in the 
reporting utility SELECT, OPTION, and REPORT 
commands. See the OS/32 Systems Support 
Utilities Reference Manual. 


Accounting times are specified and displayed by MT™ in these 
formats: 


e hh:mm:ss is the hours, minutes, and seconds of elapsed 
time and signoff time (TIME OFF). 


e hh:mm:ss.ms is the hours, minutes, seconds, and 
milliseconds of user CPU time, wait time, roll 
time, OS CPU time, maximum CPU time, and 
maximum signon time. 
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e utime is the hours, minutes, seconds, and 
milliseconds of user CPU time. 


e ostime is the hours, minutes, seconds, and 
milliseconds of OS CPU time. 


@ maxtime is the hours, minutes, seconds, and 
milliseconds of maximum CPU time. 


e signontime is the hours, minutes, and seconds of 
additional signon time. 
4.5.2 Job Related Accounting Data 


The accounting data collected for each job processed is: 


e elapsed time, 

@® signon and signoff date and time, 
e job number, 

e date and time a job is submitted, 
@ total number of tasks run, 


e total number of command substitution system (CSS) calls 
executed, 


@e total number of commands entered, 

@e total number of DISPLAY FILES commands entered, 

@e user identifier (userid), 

@e renamed and deleted files, and 

® account number. 

All job related accounting data is described in the following 
sections. 

4.5.2.1 Elapsed Time 

Elapsed time is the amount of time that passes between signon and 
signoff for a particular user. Elapsed time is displayed as a 


message on the terminal user's console or batch log device each 
time the terminal user signs off: 


ELAPSED TIME = hh:mm:ss 
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4.5.2.2 Signon and Signoff Date and Time 


The signon and signoff dates and times indicate the dates. and 
times that the terminal user signs on and signs off the system. 
These dates and times are collected and stored as hexadecimal 
numbers in the ATF signon and signoff account records. Signon 
and signoff times are collected and stored in the ATF signon and 
signoff account records as the current time to the nearest 
minute. 


The signoff date and time are displayed as a message on the 
terminal user's console or batch log device each time the 
terminal user signs off. 


TIME OFF = mm/dd/yy hh:mm:ss 


4.5.2.3 Job Number 


The job number is a hexadecimal number assigned to a job 
consisting of one or more tasks. This number is collected and 
stored in the ATF signon, signoff, and task completion or data 
overflow account records. 


4.5.2.4 Date and Time a Job is Submitted 

The date and time a job is submitted to the batch queue is 
collected and stored as a hexadecimal number in the ATF signon 
account record. 

4.5.2.5 Total Number of Tasks Executed 

The total number of tasks executed as part of a batch job or 


terminal session is collected and stored as a hexadecimal number 
in the ATF signoff account record. 


4.5.2.6 Total Number of Command Substitution System (CSS) Calls 
Executed 

The total number of CSS calls executed by a batch job or terminal 

user is collected and stored as a hexadecimal number in the ATF 

signoff account record. 

4.5.2.7 Total Number of Commands Entered 

The total number of commands entered in the system by a batch job 


or during a terminal session is collected and stored as a 
hexadecimal number in the ATF signoff account record. 
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4.5.2.8 Total Number of DISPLAY FILES Commands Entered 

The total number of DISPLAY FILES commands entered in the system 
by a batch job or during a terminal session is collected and 
stored as a hexadecimal number in the ATF signoff account record. 
4.5.2.9 User Identifier (Userid) 

The userid with which the terminal user signs on the system is 
collected and stored in the ATF signon, signoff, and task 
completion or data overflow account records. 

4.5.2.10 Renamed and Deleted Files 

Data pertaining to files that are renamed or deleted is collected 
and stored in the ATF renaming or deletion account records. This 
data consists of the: 

e date and time the file was created, 

e current file descriptor (fd), 

e number of sectors in the file, 

e@e date and time the file was renamed, 


e new fd, and 


@ new account number to which the file was assigned. 


4.5.2.11 Account Number 

The account number with which the terminal user signs on the 
system is collected and stored in all the ATF account records. 
4.5.3 Task Related Accounting Data 


The accounting data collected for each task processed is: 


@ CPU time, 

e@e roll time, 

@® wait time, 

e date and time a task started and terminated, 
e userid, 


@ memory used, 
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e® count of I/O transfers to I/O devices, 

@ roll count, 

e fd from which a task was loaded, 

@® user supplied information, 

@ account number, 

@ job number, and 

@e end of task code. 

All task related accounting data is described in the following 
sections. 

4.5.3.1 Central Processing Unit (CPU) Time 

CPU time is collected and stored in the ATF task completion or 


Gata overflow account records as the number of 100 ms increments. 
All CPU time is collected and stored in three categories: 


@e user CPU time, 


} 


@ operating system CPU time, and 


@e roll CPU time. 


User CPU time is the amount of CPU time spent executing user code 
and nonreentrant system code. Operating system CPU time is’ the 
amount of CPU time spent executing reentrant system code on 
behalf of the user, and roll CPU time is the amount of CPU time 
spent rolling a task into memory. User and operating system CPU 
times are displayed as a message on the terminal user's’ console 
or batch log device. The following message is displayed when a 
terminal user's task terminates: 


taskid-END OF TASK CODE=xxxx CPUTIME=utime/ost ime 

The fei towing message is displayed when data overflow occurs: 
taskid-ACCOUNTING DATA RESET CPUTIME=utime/ost ime 

The following message is displayed when the terminal user. signs 


off: 


CPUTIME=utime/ost ime 
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The user and operating system CPU times can also be displayed by 
the DISPLAY ACCOUNTING command. See the 08/32 Multi-Terminal 
Monitor (MTM) Reference Manual. 


4.5.3.2 Roll Time 


Roll time is the time a task spends waiting to execute because it 
was rolled out of memory. All roll time is collected and stored 
in the ATF task completion or data overflow account records as 
the number of 100 ms increments. Roll time can be displayed by 
the DISPLAY ACCOUNTING command. See the 0S/32 Multi-Terminal 
Monitor (MTM) Reference Manual. 


4.5.3.3 Wait Time 


Wait time is the time a task spends waiting to execute because of 
a request that task issued for itself (e.g., I/O request). Wait 
time excludes all PAUSE requests and the time a task spends 
suspended by another task or by the terminal user. All wait time 
is stored in the ATF task completion or data overflow account 
records as the number of 100 ms increments. Wait time can be 
displayed by the DISPLAY ACCOUNTING command. See the 0S/32 
Multi-Terminal Monitor (MTM) Reference Manual. 


4.5.3.4 Date and Time a Task Started and Terminated 

The date and time a task started and terminated is collected and 
stored in the ATF task completion or data overflow account 
records as the number of 100 ms increments. 

4.5.3.5 User Identifier (Userid) 

The userid with which the terminal user signs on the system is 
collected and stored in the ATF signon, signoff, and task 
completion or data overflow account records. 

4.5.3.6 Memory Used by a Task 

The total amount of memory used by a task during execution is 
collected and stored in the ATF task completion or data overflow 
account records as the number of 256-byte segments. Memory used 
is collected and stored in three categories: 

e impure segment space, 


e shared segment space, and 


@e® system space. 
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Impure segment space is the maximum amount of impure memory’ used 
by a task during execution. Shared segment space is the maximum 
amount of shared memory (i.e., pure, TCOM, RTL) used by a task 
during execution, and system space is the maximum amount of 
system space used by a task during execution. 


4.5.3.7 Count of Input/Output (1/0) Transfers to I/O Devices 


All I/O transfers (read, write, test and set) made to an =I/0O 
device assigned to a particular device class are _ counted, 
collected, and stored as a hexadecimal number in the ATF task 
completion or data overflow account records. These numbers are 


stored in the appropriate class category in the ATF. Each 1/0 
class supported by the accounting facility occupies eight bytes 
in each ATF account record. The number of bytes transferred 


every time an I/O transfer occurs is counted and stored as a 
hexadecimal number in the ATF. The count of I/O transfers can be 
displayed by the DISPLAY ACCOUNTING command. I/0 transfer limits 
are established at MTM SYSGEN time by the IOTAB or UIOLIM macros 
(Chapter 2 of this manual) and can be overridden by the terminal 
user for batch jobs through the SIGNON command. See the 0S/32 
Multi-Terminal Monitor (MTM) Reference Manual. 


4.5.3.8 Roll Count 


Roll count is the total number of times the impure segment of a 
task is rolled into memory. The roll count is collected and 
stored as a hexadecimal number in the ATF task completion or data 
overflow account records. The roll count can be displayed by the 
DISPLAY ACCOUNTING command. See the OS/32 Multi-Terminal Monitor 
(MTM) Reference Manual. 


4.5.3.9 File Descriptor (fd) from which a Task was Loaded 


Every time a task is loaded, the fd from which it was loaded is 
stored in the ATF task completion or data overflow account 
records. This data aids the user in determining which system 
tasks are used more often, and whether they should be made 
resident or nonresident. 
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4.5.3.10 User Supplied Information 

User supplied information is eight bytes of data supplied by the 
terminal user through the SETACCT macro. This information is 
stored in the ATF task completion or data overflow account 
records. See the OS/32 System Macro Library Reference Manual. 
4.5.3.11 Account Number 

The account number with which the terminal user signs onto the 
system is collected and stored in all ATF account records. 
4.5.3.12 Job Number 

The job number to which a particular task is assigned is 
collected and stored in the ATF signon, signoff, and task 
completion or data overflow account records. 

4.5.3.13 End of Task Code 

The end of task code with which each task terminates is collected 
and stored in the ATF task completion or data overflow account 


records. The code is displayed on the terminal user's console or 
batch log device each time a user's task terminates: 


taskid-END OF TASK CODE=xxxx CPUTIME=utime/ostime 
If a task exceeds the CPU time limit, the end of task code 1200 
is displayed when the task terminates. 
If a task exceeds the I/O transfer limit, the end of task code 
1210 is displayed when the task terminates. 


4.6 TERMINAL USER ACCESS TO ACCOUNTING INFORMATION 


A terminal user can access accounting information: 


@e at task termination, 
@e when a task control block (TCB) counter overflow occurs, 
e at signoff time, 


e through the DISPLAY ACCOUNTING command (see the OS /32 
Multi-Terminal Monitor (MTM) Reference Manual), or 


e through the fetch accounting information (FETACCT) macro (see 
the OS/32 Multi-Terminal Monitor (MTM) Reference Manual). 
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4.6.1 Task Termination 


When a terminal user's task terminates execution, accounting 
information is displayed on the terminal user's console or batch 
log device in this message: 


taskid-END OF TASK CODE=xxxx CPUTIME=utime/ostime 


4.6.2 Task Control Block (TCB) Counter Overflow 
When the counters for data collection in the TCB overflow, this 


accounting information is displayed on the terminal user's 
console or batch log device in this message: 


taskiad-ACCOUNTING DATA RESET CPUTIME=ut ime/ostime 


4.6.3 Signoff Time 


When a terminal user signs off the system, accounting information 
is displayed to the terminal user's console or batch log device 
in these messages: 


ELAPSED TIME=hh:mm:ss CPUTIME=utime/ostime 
SIGNON LEFT=hh:mm:ss CPU LEFT=hh:mm:ss 
TIME OFF=mm/dd/yy hh:mm:ss 


If there are no sign on or CPU time limits set for the account, 
SIGNON LEFT= and CPU LEFT= are not displayed at sign off. 
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CHAPTER 5 
MULTI-TERMINAL MONITOR (MTM) OPERATING PROCEDURES 


5.1 INTRODUCTION 

Before loading and starting MTM, an authorized user file (AUF) 
must already exist. See Chapter 3. The commands used to load, 
establish, start, and control MTM are presented in this chapter. 
5.2 LOADING AND ESTABLISHING THE MULTI-TERMINAL MONITOR (MTM) 
The following two commands load and establish MTM as the. current 
task: 


Formats: 


LOAD .MTM,fd 


TASK .MTM 
Parameter: 


fd is the file descriptor of the device from 
which MTM is loaded. 


Functional Details: 


The priority of MTM is established when MTM is linked. To ensure 
that MTM is not at the same level as the real-time system, MTM 
should be set at a priority lower than the lowest priority of 
real-time tasks in the operating system. If MTM is set at a 
lower priority, it executes as a background system. Since MTM is 
almost totally input/output (1/0) bound, it does not interfere 
with other tasks. Tasks executing in an MTM environment will run 
at a maximum priority of one less than the priority of MTM. 
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5.3 


START COMMAND 


The START command starts MTM. Parameters for the START command 
may be specified in any order. 


For 


mat: 


START ,AUF=fd [ATF=fd] [ PERMINAL= (£4, Fidje2294q] )| 


[,BATCH=(n,fd)] [, PAGE=fd] 


Parameters: 


AUF = 


ATF = 


TERMINAL= 


BATCH= 


fd is the file descriptor of the authorized 
user file (AUF). This file must reside on 
account 255. The authorized user utility must 
be used to create the AUF prior to running 
MTM. This parameter is required. 


fd is the file descriptor of the accounting 
transaction file (ATF). The ATF accumulates 
accounting data in systems with accounting 
support. If the indicated file exists, 
records are appended. If it does not exist, 
MTM automatically allocates it: This 
parameter must be specified if the operating 
system is generated with accounting support. 
A user who does not wish to retain accounting 
information may specify ATF=NULL. 


fd is the file descriptor of the terminal 
devices that MTM is to monitor. Up to 64 
terminal fds can be specified. If the command 
line entered exceeds one line, specify 
additional terminal devices with the .MTM ADD 
command. 


nis a decimal number from 1 through 64 
indicating the number of concurrent batch 
streams that MTM can start. 


fd is the file descriptor of the batch queue. 
The batch queue is an indexed file containing 
fds of the batch streams to be processed. If 
the fd specified does not exist, MTM allocates 
the file. 
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PAGE= | fd is the file descriptor of the page file 
used by local and global variables. If this 
parameter is omitted, MTM automatically 
allocates a file mamed PAGE on the system 
volume, account 255. 


Functional Details: 


The number of concurrent batch streams allowed, plus the number 
of terminals to be monitored, cannot exceed the maximum number of 
users allowed (NUSERS) at MTM system generation (sysgen). 


MTM can optionally load and start an assistant task (which runs 
under the task name .MTMASST). An assistant task executes a 
supervisor call 7 (SVC7) on behalf of MTM. This task can improve 
MTM response time because MTM does not have to wait while an SVC7 
is in progress. 


When started, MTM tries to load and start the assistant task. 
MTM assumes that the assistant task image is on the file 
MTMASST.TSK on the system volume. If this file does not exist, 
or if the load fails, MTM is not affected. However, MTM issues 
its own SVC7 calls and response time is slower. 


Because the operating system cancels all subtasks when the 
monitor task goes to end of task, .MTMASST is also cancelled when 
MTM goes to end of task. If an attempt is made to restart MTM, 
MTM goes to end of task 254. 


When MTM is started from a CSS file, and an .MTM command 
immediately follows the START command, an SVC6-ERR TYPE=QUE 
POS=.MTM error may occur. This error results if MTM task has not 
completed initialization when the .MTM command is_- entered. To 
avoid this problem, put time delay commands such as §$WAIT 2 
between the START and .MTM commands. 


Example: 


This command starts MTM using an AUF named ACCTS.32/255 and an 
ATF named ATF./255. Three terminals are to be monitored. Four 
batch jobs may run concurrently, and the file BATCH.Q is assigned 
as the batch queue. 


ST,AUF=ACCTS .32,ATF=ATF ,T=(CR10: ,CR12:,CR14:) ,B=(4,BATCH.Q) 
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5.4  .MTM COMMAND 
The .MTM command enables the system operator to control MT, its 


terminals, and users from the system console. 


Format: 


WAITS 

TERMINAL 
STATUS|,< BATCH 

USED [fdj] 


nt batch and terminal 


TELL 
userid message 
MESSAGE 
BROADCAST message 
device: 

cH n [fd] 
TERMINATE device: 

eed 


senove} 
BATCH n 


PURGE fd 
INQUIRE [fd] 
SUBMIT fd 
ATF fd 
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Parameters: 


STATUS 


WAITS 


TERMINAL 


BATCH 


USED 


fd, 


TELL 
MESSAGE 


userid 


BROADCAST 
message 
ADD 


device 
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displays current information. If no _ further 
parameter is specified, information on 
terminal users and batch jobs is displayed. 


displays to the system console system 
resources available to MTM, the peak usage of 
system resources, and the number of times 
users had to wait for resources to become 
available. 


indicates that terminal information is to be 
displayed. 


indicates that batch information is to _ be 
displayed. The number of batch streams that 
can run concurrently is also displayed. 


displays in histogram form the number of times 
a command buffer was used during MTM 
execution. See Figure 5-1 for an example of 
a listing output by the USED parameter. 


specifies the file or device to which the 
output from the USED parameter is sent. If fd 
is omitted, the system console is the display 
device. 


displays a message on a specified user 
terminal. 


displays a message on a specified user 


terminal. 
identifies the terminal user. 


displays a message on all terminals whether or 
not they are in use. 


is a l- to 62-character alphanumeric string 
indicating the message to be broadcast. 


adds an additional terminal or concurrent 
batch to the MTM system. 


is the new terminal to be added. The total 
number of terminals supported by MTM must not 
exceed (NUSERS - number of batch streams). 


fd 


TERMINATE 


device 


REMOVE 


device 


QUIESCE 


is the number of additional concurrent batch 
streams to be allowed. The total number of 
concurrent batch streams supported by MTM must 
not exceed (NUSERS - number of terminals). 
This parameter increases the number of 
allowable concurrent batch streams supported 
by MTM but does not add batch streams to the 
batch queue. To add batch streams to the 
batch queue, use the SUBMIT command. 


specifies the file descriptor of the batch 
queue file. If a batch queue currently 
exists, this parameter is ignored. 


immediately cancels a terminal user's task and 
signs off a terminal user. This parameter 
does not affect batch jobs. 


is the terminal to which the user to be 
terminated is signed on. 


stops MTM from accepting commands at a 
specific terminal or reduces’ the number of 
allowable concurrent batch jobs. 


is the terminal to be removed. If the 
terminal is currently in use, the terminal 
user is allowed to continue until a SIGNOFF 
command is entered. When the terminal is 
removed, MTM closes the lu assignment for’ the 
terminal. 


is the number of concurrent batch streams’ to 
be removed. Currently active jobs are allowed 
to complete execution. If n is greater than 
the number of current batch streams, the 
number of concurrent batch streams supported 
by MTM is reduced to zero. If the new number 
of batch streams is less than the number of 
currently active batch jobs, the extra batch 
jobs are allowed to go to completion. 


terminates MTM; new signons are prevented and 
batch job initiation is stopped. When all 
terminal users sign off the system and all 
currently active batch jobs terminate, MTM 
goes to end of task. Before MTM goes to end 
of task, information on the availability and 
usage of, and the number of times users had to 
wait for, system resources is output. If MIM 
discovers that command buffers are missing 
(the buffer chain has been broken) it pauses 
to allow user action (such as a panic dump). 
When the CONTINUE command is entered MTM goes 
to end of task code 210. 


48-023 FOO RO2 


PURGE removes a batch job from the system and from 
the batch queue. If the batch job is 
currently active, it is cancelled. 


fd is the file descriptor of the file containing 
the batch job. 


INQUIRE displays the status of a batch job. 


fd is the file descriptor of the file containing 
the batch job. If fd is omitted, the status 
of all submitted jobs is displayed. 


SUBMIT adds a job to the batch queue. 


fda is the file descriptor of the file containing 
the batch job to be added to the batch queue. 


ATF changes the accounting transaction file. The 
current ATF is closed and a new ATF is 
allocated (if necessary) and assigned. 


fd is the file descriptor of the new ATP. 


Functional Details: 


-MTM STATUS,WAITS, .MTM QUIESCE, and .MTM STATUS,USED can be used 
to determine if the numbers specified at MIM sysgen for command 
buffers (NCSBFS), console buffers (NCONBFS), sector buffers 
(NSECTS), and logical units (LNKOPT) are optimal. Increasing the 
available resources at MTM sysgen can help to eliminate excessive 
wait conditions. Decreasing resources can eliminate unnecessary 
memory overhead. 


Examples: 


-MTM STATUS Command: 


-MTM STA 
-MTM: TERMINAL USERS - 
.MTM; 0S832-BATCH>MTM-MODE 0S3220-BATCH>MTM-MODE LEE-CT42:>MTM-MODE 
-MTM: ROD-CT4C : )MTM-MODE RICH-CT7A: @MTM-MODE LAURIE-CT7C: @MTM-MODE 
-MTM: JOB M300:0S832.J0B/96 EXECUTING USER ID=0S832 
.MTM: JOB M300:083220.J0B/96 EXECUTING USER 1ID=0S3220 
-MTM:WAITING JOBS = 1 
-MTM: 2 BATCH STREAMS 
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-MITM STATUS,WAITS Command: 


-MTM STA,W 


CURRENT 


WATTS 


TOTAL PEAK CURRENT WAITS 
42 32 29 O CMD BUFFERS 
0 0 0 O CON BUFFERS 
7 4. 0 O SEC BUFFEFS 
50 10 6 O LU 
indicates the maximum number available. 
indicates the maximum number concurrently 
used. 
indicates the number in use at the time 
the command was executed. 
indicates the number of times users were 


placed in a wait state. 


-MTM STATUS , TERMINAL Command: 


-MT™M STA,T 


-MTM: TERMINAL USERS - 


-MTM:0S83 
.MTM: ROD- 


2-BATCH>MTM-MODE 0OS3220-BATCH>MTM-MODE JI.EE-CT42: >)MTM-MODE 
CT4C: )MTM-MODE RICH-CT7A: @MTM-MODE LAURIE-CT7C: @MTM-MODE 


-MTM STATUS, BATCH Command: 


-MTIM STA,B 


-MTM: JOB M300:0S832.J0B/96 EXECUTING USER ID=0S832 
-MTM: JOB M300:0S3220.J0B/96 EXECUTING USER ID=0S3220 
-MTM:WAITING JOBS = 1 


-MTM: 


2 BATCH STREAMS 
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-MTM STATUS,USED Command: 


| USED # OF TIMES USED --> 
| CMDB 'S 10**1 10**2 10**3 10**4 10**5 10**6 10**7 10**8 10**9 
Lo 
x ! 
3 It | 
4 [ex H 
5 [kkkke i 
6 [| xeewK | 
7 [ReeRe | 
QB pean { 
9 | ee kak | 


LO) ok ke 
LL [Ree RRR KR 
LOI IIR 
V3 iO 

14 IO Ook 

5 ROI ICI k 

16 [Gk 

17 ROI OI IO II III 
LB OOO io | 


19 [RARER RRR ERK ERR 

20 [RRR RR Rk 
21 [RRR RRR ERK KR RRR KA KEK KK KEKE 
22 [RRA KRR KAR REREER 
23 [RO RK 
24 [RR RR RR RK EK RK 
25 PRK RK IR RRR RRR REE 
26 pO IOI OR Kk 


27 [OO Ok 
28 [ROR Ok i kk 


ie 
oO 


Figure 5-1 Sample Output from the .MTM STATUS,USED Command 


This command displays, in histogram format, the number of times 
the indicated number of command buffers were used concurrently. 


Figure 5-1 indicates, 


for example, that four command buffers were 


concurrently used three times, 12 were concurrently used 90 
times, and 24 were concurrently used 900 times. 
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.MTM TELL and .MTM MESSAGE Commands: 


-MTM TEL SAM, YOUR MAG TAPE IS MOUNTED. 


-MTM ME SAM,YOUR MAG TAPE IS MOUNTED. 


Sends the indicated message to the terminal signed on with 
user-id of SAM. 


-MTM BROADCAST Command: 
-MTM BRO MTM IS GOING DOWN IN 15 MINUTES. 
Sends the indicated message to all terminals curren 
assigned to MTM. 
-MTM ADD Command: 
-MTM ADD CRT2: 
Adds the device CRT:2 to MTM. 
-MTM ADD BATCH 2 
Increases the number of batch streams allowed by 2. 
-MTM TERMINATE Command: 
.MIM TER CRT8: 
Terminates the user signed on to CRT8:. 
-MTM REMOVE Command: 


-MTM REM CRL1O: 


Removes CRT10: from MTM upon the next sign off command. 
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-MTM REM BATCH 3 


Decreases the number of batch streams allowed by 3. 


-MTM QUIESCE Command: 


-MTM QUIES 


Terminates MTM after all users have signed off and all batch 
jobs have terminated. The following table is output prior to 


MTM termination. 


-MTM QUIESCE 


-MTM: TOTAL PEAK CURRENT WAITS 


-MTM: 42 32 29 O CMD BUFFERS 
-MTM: 0 0 0 O CON BUFFERS 
-MTM: 7 4 0 0 SEC BUFFERS 
MTM: 50 10 6 O LU 


-MTM END OF TASK CODE 0 
-MTM PURGE Command: 
-MTM PUR MT30:TEST.JOB/8 


Cancels the indicated batch job if active, or removes it 
the batch queue if not active. 


-MTM INQUIRE Command: 


-MTM INQ 
-MTM: JOB M300:0S832.J0B/96 EXECUTING 
-MTM: JOB M300:083220.J0B/96 EXECUTING 
-MTM: JOB M300:0S3230.J0B/96 WAITING 


Displays the status of all submitted jobs. 


.MTM INQ FRED: TASK.JOB/18 
JOB FRED: TASK.JOB/18 NOT FOUND 


Displays the status of the specified job. 
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-MTM SUBMIT Command: 


-MTM SUB MT30:TEST.JOB/8 


Adds the specified job to the batch queue. 


5.5 MULTI-TERMINAL MONITOR (MTM) END OF TASK CODES 


With the exception of end of task codes O and 255, 


end 


of 


-MTM END OF TASK CODE nnn 


MTM goes 
task due to ae situation that it cannot resolve. 
format of the end of task message on the system console is: 


to 
The 


The MTM end of task codes and meanings are listed in Table 5-1. 


i de ee ee ee ee 


0 


1 


2 


ll 


TABLE 5-1 MTM END OF TASK CODES 


MEAN ING 


No message buffers 
Entry is removed from the task queue. 


Task has just been loaded but its task 
control block cannot be located. 


An SVC 6 error has occurred but the 
error is not listed in the error table. 


-MTM START parameter(s) is wrong. 


A command buffer length of less than 72, 
or NUSERS less than 1, was specified. 


Address for the DMT in the VMT is 0O 
for a direct access volume. 


A read or write request was made to 
record OQ in the batch queue. This 
request is illegal. 


Number of I/O classes in the operating 
system is larger than those in the MT 
sysgen. 


== asm eee cee eee wee co eee eee eee eee eee eee eee eee ee ee we we eee ee ee we oe 


=aes 
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TABLE 5-1 MTM END OF TASK CODES (Continued) 


Cael neal eee lll ae ene nl ce ae ee te ee i A ie Rc ee ey 


| CODE } MEAN ING 
i 12 | MTM could not assign the system jj 
! console. H 
i 13 | MTM could not assign the accounting | 
| {| transaction file. { 
} 200 | PSM was specified without accounting i 
H } support. H 
i 210 {| Command buffers missing upon .MTM H 
H {| QUIESCE (Buffer chain broken). { 
i 254 | User attempted to restart MTM. MTM is | 
H {| not a restartable task. H 
} 255 | MTM has been cancelled. 


Ce cena ll nee cree  e RD ee e ce  e ee ee 


5.6 MULTI-TERMINAL MONITOR (MTM) ERROR MESSAGES 


BATCH ASGN-ERR TYPE=ASGN JOB=fd/act 


indicates the lu was not assigned when trying to 
file at the start of a batch job. 


BATCH ASGN-ERR TYPE=BUFF JOB=fd/act 


indicates insufficient system space to obtain file 
block (FCB) 
batch job. 


assign a 


control 


when trying to assign a file at the start of a 


BATCH ASGN-ERR TYPE=FUNC JOB=fd/act 


indicates invalid function detected for specified device/file 
when trying to assign it at the start of a batch job. 


BATCH ASGN-ERR TYPE=I/0O JOB=fd/act 


indicates I/O error detected on specified file when trying to 
assign file at the start of a batch job. 
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BATCH ASGN-ERR TYPE=lu JOB=fd/act 


indicates illegal or unassigned lu detected when trying to 
assign a file when starting a batch job. 


BATCH ASGN-ERR TYPE=NAME JOB=fd/act 


indicates mismatched filename.ext detected when trying to 
assign a file at the start of a batch job. 


BATCH ASGN-ERR TYPE=PRIV JOB=fd/act 


indicates mismatched access privilege detected when trying to 
assign a file at the start of a batch job. 


BATCH ASGN-ERR TYPE=SIZE JOB=fd/act 


indicates erroneous record length/size detected when trying 
to assign a file at the start of a batch job. 


BATCH ASGN-ERR TYPE=VOL JOB=fd/act 


indicates no such volume/device detected when trying to 
assign a file at the start of a batch job. 


BATCH NOT ACTIVE 


indicates MTM was started without a batch queue, and a _ batch 
request had been made. 


BATCH QUEUE ASGN-ERR 


indicates the batch queue specified in the START command 
could not be assigned. 


BATCH QUEUE I/O-ERR TYPE=DU- - -ALL BATCH REMOVED- - - 


indicates device unavailable detected on batch queue. 


BATCH QUEUE I/O-ERR TYPE=EOF- - -ALL BATCH REMOVED- - - 


indicates end of file error detected on batch queue. 


BATCH QUEUE I/O-ERR TYPE=EOM- - -ALL BATCH REMOVED- - - 


indicates end of medium error detected on batch queue. 
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BATCH QUEUE I/O-ERR TYPE=PRTY- - -ALL BATCH REMOVED- - - 


indicates parity or recoverable error detected on batch 
queue. 


BATCH QUEUE I/O-ERR TYPE=UNRV- - -ALL BATCH REMOVED- - - 


indicates unrecoverable error detected on batch queue. 


BATCH QUEUE LRECL-ERR 


indicates batch queue given in the START command has_ an 
invalid record length of less than 40 bytes. 


CANNOT ASSIGN AUF FILE 


indicates that MTM cannot assign an AUF file. 


xxxx CMD BUFFERS MISSING 


indicates that the number of command buffers specified by 
xxxx have been discovered to be missing upon .MTM QUIESCE. 


COMMAND BUFFER LENGTH LESS THAN 72 


indicates that a command buffer length of 72, or NUSERS less 
than 1 was specified. 


dev-I/O ERROR status USER TERMINATED 


indicates unrecoverable error has occurred on a device; error 
status returned indicated as status. MTM automatically signs 
off a user signed on to the device. 


EXTRANEOUS OPERANDS 


indicates an MTM command has too many operands. 


FILE DESCRIPTOR ERROR 


indicates the fd specified in the command is omitted, or its 
format is incorrect. 


INVALID COMMAND 


indicates the entered MTM command is unrecognized. 
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INVALID PARAMETER 
indicates a command has been entered with an invalid 
parameter, bad syntax, or the device cannot be found. 

NO BUFFER AVAIL FOR CMD 


all the command and message buffers are full. 


START OPTIONS FORM-ERR 


indicates invalid format in the START command. 


START OPTIONS PARM-ERR 


indicates invalid START parameter. 


TERMINAL ASSIGN ERROR 
indicates adding a new terminal to the system has failed. 
The device is not recognized or not available. 

TERMINALS OR BATCH EXCEED MAXIMUM 
indicates number of concurrent batch streams allowed exceeds 
64; number of terminals exceeds 64; number of batch streams 
and terminals exceed the NUSERS established at MTM sysgen 
time. 


USERID NOT FOUND 


indicates a current user has not been found with this 
identification. 
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APPENDIX A 


MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION (SYSGEN) OPTIONS 


CDBUFSIZ EQU n 


CONBFSZ EQU n 


CPULIMIT EQU n 


CSBFSZ EQU n 


IOTAB macro: 


(size of sector buffers) 


(size of console buffers) 


(CPU time Limit) 


(size of command buffers) 


(I/O class number, identification, 


[label] IOTAB (classno,classid [, iocount]), 


(classno,classid [, iocount]), 


NCONBFS EQU n 


NCSBFS EQU n 


NCSSLVS EQU n 


NMSGS EQU n 


NSECTS EQU n 


NUSERS EQU n 
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(number 


(number 


(number 


(number 


(number 


(number 


of 


of 


of 


of 


of 


of 


console buffers) 

extra command pugters) 
CSS levels) 

message buffers) 

sector buffers) 


concurrent users) 


PRMTDEV macro: (device to which prompt sequence applies) 


[label] PRMTDEV (pname, ,dev; [,---,devn ])4 
[eacen(pnamen dev [.--+1devn})y | 


[label] PRMTDEV (SIGMA,dev, [,...,dev, ]) 


PRMTSEQ macro: (prompt sequence; command, task, build) 


[Label] PRMTSEQ (SIGMA) 


[iabel] PRMTSEQ (pname; , (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x) ), 
(pnamen, (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x))p 


[label] PRMTSEQ (STANDARD, (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x), 


QUESIZE EQU n (size of task queue) 

SGN.ACT EQU n (accounting support/number of classes) 
0 

SGN.BTCP EQU (batch job pause) 
1 


SGN.MVOL EQU C'name' (default user volume) 


SGN.PRIO EQU n (batch priority) 


SGN.SCHR EQU n (subtask scheduling) 
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0 
SOW ROL. B90) 
1 


SGN.SPL EQU n 
SGN.VAR EQU n 
SGN.@GLO EQU n 


SGN.@INT EQU n 


0 
SGN. $HSP E90 
1 


UCPULIM macro: 


(tasks rollable) 


(SPL/32 support/number of buffers) 
(numbers of variables) 
(number of new global variables) 


(number of internal variables) 
(HASP interface) 


(CPU time limits for I/O classes) 


[label] UCPULIM limitgt,limitob,...,...,Llimitnt, Limityb 


UIOLIM macro: 


(I/O limits, all I/O classes per user class) 


[label] UIOLIM (Upidgt,...,UgiOnt), (Ugiogb,...,Ugionb) 


fFeeoee ¢ 


v 


VERSION macro: 


[label] VERSION ‘id! 
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(MTM parameter file identification) 


APPENDIX B 
AUTHORIZED USER UTILITY COMMANDS 


ACCOUNTS n 


- | 


signont ime CPUt ime) 
ADD actno,groupno, password, [user id] r ;: | 
* 


;privileges 
L 3] 


x * 


| | signont ime CPUt ime 
CHANGE actno,[groupno] , [password], [userid] ; ‘ 


[-privileges] 
DELETE actno 
END 
LIST [actno 1 [-actno 2]] 


CREATE 


MODE | (UPDATE > | =fd, 


REPORT 
PAUSE 
privileges 
PRIVILEGE | actno, [,actnog] |, 
x 
CREATE 
COMMAND 
START, =fd,,LIST=fd2 ,{ UPDATE >=fd3 [, ACCOUNTS=n | 
CMD 
REPORT 
TOTAL [c_] 
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APPENDIX C 
AUTHORIZED USER UTILITY MESSAGE SUMMARY 


taskid > for CON: 
or 
-~--> under MTM 


is the prompt, generated for an interactive device, 
indicating an input request. 


ACTUTILITY rr-uu 


identifies the account utility. The revision level is rr; 
the update level is uu. This message is output only at the 
initial start of the utility. 


ACCOUNT UTILITY RUN xx/xx/xx yy:yy:yy 


appears on the system console when the utility is started. 
It informs the operator that the account utility has been 
run. 


*XxXSET DATE & TIME 


is the date request that pauses the utility so the current 
date and time can be set for the system. The system CONTINUE 
command transfers control back to the utility. This message 
is output when the date and time are not set. 


**xXxXACCOUNT NUMBER xxx WAS INACTIVE 


indicates the requested command could not be performed 
because the indicated account record was inactive. The 
indicated account number is xxx. 


***XACCOUNT NUMBER xxx WAS ACTIVE 


indicates the requested command could not be performed 
because the indicated account record was already active. The 
indicated account number is xxx. 


48-023 FOO RO2 C=1 


ACCOUNTS=n 


indicates the maximum account number on the current AUF. 


**k*k¥xxxxx IS THE CURRENT MODE 


indicates the output from the MODE command. The name of the 
current mode (CREATE, UPDATE, or REPORT) is xxxxxx. 


is the question mark, along with some of the _ following 
messages, used to denote which parameter in the command 
caused the error. The command and a pointer (?) to the 
location of the error is displayed to the command input 
device. 
**x* TLELEGAL [INPUT COMMAND 

indicates the command word or abbreviation could not be found 
in the table of legal commands. 


***WRONG MODE FOR INPUT COMMAND 


indicates the current mode does not allow the input command. 


**x*xTLLEGAL COMMAND FORM 


indicates the input command uses too many separators or a 
separator other than a comma or equal character. 


***xT LLEGAL PARAMETER 


indicates the input command is missing a required parameter 
or has too many parameters. 


**xxXTLLEGAL START PARAMETER 


indicates a START command word or abbreviation was not found 
in the START command table. 


**X*DUPLICATE START PARAMETER 


indicates the START command contains a duplicate command word 
or more than one mode request. 
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*** ILLEGAL FILE DESCRIPTOR 


indicates the file Gescriptor used is syntactically 
incorrect. 


**X*xXMISSING START PARAMETER 


indicates at least one START parameter is missing from the 
specified mode. 


** xX ATL LOCATION/ASSIGNMENT ERROR 


indicates a file cannot be allocated because of a filename 
conflict or the filename specified for the assignment could 
not be found on the specified disk. 


**k*]u xx NOT ASSIGNED 


indicates a requested function could not be performed because 
the logical unit xx was not assigned. The utility is paused 
and control transfers to the system. The system CONTINUE 
command continues the utility after the assignment. 


*x*x INPUT DEVICE ERROR xx on LOGICAL UNIT yy 


indicates an input request has an I/O error on device xx 
assigned to logical unit yy. The authorized user utility 
pauses. The system CONTINUE command transfers control back 
to the utility. 


***xOUTPUT DEVICE ERROR xx ON LOGICAL UNIT yy 
indicates an output request has the I/O error on device xx 
assigned to logical unit yy. The authorized user utility 
pauses. The system CONTINUE command transfers control back 
to the utility. 

***xMISSING PARAMETER 
indicates the input command is missing a required parameter. 
On input errors, where the form of the command or its 
characters are incorrect, the command and a pointer (?) to 
the location of the error is displayed to the user console. 


***XMODE NOT ALLOWED 


indicates an attempt to perform an UPDATE or a REPORT was 
made from an account other than 255. 
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***WARNING ACCOUNT 255 DOES NOT EXIST 


indicates an attempt to end utility when account 255 does not © 
exist. 
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APPENDIX D 
ACCOUNTING TRANSACTION FILE (ATF) RECORD FORMATS 


The data structure of the ATF is defined by the $ATF data 
structure macro contained in SYSSTRUC.MLB. The fields and 
functional values in the ATF account records have standard 
symbolic names. These names may be accessed by coding and 
expanding the $ATF data structure macro. See the Common Assembly 
Language Macro/32 Processor (CAL Macro/32) and Macro Library 
Utility Reference Manual. Each of the six ATF account’ record 
types is associated with a particular type of account activity. 
The record length of an ATF record varies with the number of 
input/output (1/0) classes supported by the system. The record 
formats shown in this appendix are 128 bytes and accept entries 
for the four default I/O classes. The record types are listed in 
Table D-1l. 


TABLE D-1 ATF RECORD TYPES 


} TYPE | RECORD ACTIVITY 
Ty signon 
| 2 | Signofe | 
| 3 | Task completion | 
| 4 | Task data overflow | 
| 5 | File deletion | 
| 6 | File renaming ! 


ee A I A a eS ee NO me Se ere me 


These six record formats are illustrated in the following 
sections. 
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} O(0) RECORD TYPE i 2(2) ACCOUNT NUMBER H 
H (ATF .TYPE) (ATF .ACCT) H 
lee eneinb aise ees an micas ssc e eee a ae mine es a gee oe ae eee | 
|} 4(4) CURRENT DATE AND TIME H 
H (ATF .CRTM) | 
ca a a a ee a 
| 8(8) ! 
{ -----= USER IDENTIFICATION =) #=7--=-= H 
} 12(C) (ATF .UID) H 
| ee ee 
{ 16¢€10) JOB SERIAL NUMBER 

| (ATF .JOB) H 
| ee en ee eee 
| 20(14) 
Pm mm a a ae H 
! 24(18) FILE DESCRIPTOR OF ! 
eee it tae, |. ...-«-—S» 
; 28(1C) COMMAND INPUT FILE i 
eae —t—“‘( Ci ee C(“‘“ié‘O™OCS*C*C*#CMRG | 
i 32(20) (ATF .UFD) i 
cee | 
| 36(24) 
Coenen piaiar a ain aie ens Bee gem nigel ek | 
i 40(28) DATE AND TIME JOB WAS SUBMITTED 
| TO BATCH QUEUE (ATF .SUBT) H 
Se ne oe 
| 44(2C) 
| —-—-——-—— FILGER- 4 4 4 4 > Bebe iets H 
} 48(30 
Ge eee oe ae wen ar ty, ahs tae Rent Siva LO ne A oo putas tas, es as Bs eet, PN Nr ea ac eR Ba Vigne en ee ae | 

ce 

td e 
| ~------ +--+ 2-2 nnn nn nnn nee nee | 
| 116(74) 
ee a  —C 
} 120(78) FILLER | 
ee | 
} 124(7C) 


ATF FORMAT FOR SIGNON ACCOUNT RECORD TYPE 


Lee en et a ee ee ee ted 


- 


Ce ene ee eee 
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ATF FORMAT FOR SIGNOFF ACCOUNT RECORD TYPE 


Cn Ne err ee anette i eae eet ane eat ee ae eee he ae oie ciel 


| O(0) RECORD TYPE | 2(2) ACCOUNT NUMBER 

(ATF .TYPE) . (ATF .ACCT) 

| eee ee ee een 
| 4(4) CURRENT DATE AND TIME 

| ars CRTM) 

| sae nm ce ee eo ee ea OE YS Sen SOY UE SND OUD Oe cum OND nh SR SO, sn OS GOED SPD SY SO OED SOR SOC Lm Se teh Sa nw ee my cee Oe ce ee nee 
| 8(8) | 

[S=—>5 USER IDENTIFICATION 2 2 t= == 
t 12(C) (ATF .UID) 

H ane ene eee en ee ee ee ee ee ee eee ns 
| 16(10) JOB NUMBER 

| (ATF . JOB) 

' 

' 


{| 20(14) NUMBER OF TASKS RUN! 22(16) NUMBER OF CSS CALLS 
(ATF . TASK) (ATF . CSS) 


24(18) NUMBER OF COMMANDS 26(1A) NUMBER OF DISPLAY 


{ ‘] 

ENTERED FILES (ATF .DISF) 
Yo ATPCMDS) 
28(1C) ELAPSED TIME (ATF. ELPS) 

Lo 7 
0 
136024) 
AL 

ha rm a 
jue) SSS 
| 120(78) Se 
homes. ll 


ee De te een 
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ATF FORMAT FOR TASK COMPLETION (ATYP.TSK) AND TASK DATA 


OVERFLOW ACCOUNT RECORD TYPES 


ee re Re een en ee ee ee ee 


0(0) RECORD TYPE i 2(2) ACCOUNT NUMBER 
AE oaeey. i (ATF. ACCT) 
4(4) CURRENT DATE AND TIME(ATP Joe) 
8(8) 
Selatan USER IDENTIFICATION <== = 
12(C) (ATF .UID) 
16 (10) JOB SERIAL NUMBER (ATF . JOB ) 
20*) TIME TASK WAS STARTED(ATF. STAR) 
zaCts) 
28(1C) FD OF TASK 
32(20) (ATF .TFD) 
36(24) 
40(28) ACCOUNT NUMBER | 42(2A) END OF TASK CODE 
(ATF .ACT) (ATF .RC) 
44(2C) 
Same USER-SUPPLIED INFORMATION ------ 
48(30) (ATF .USER) 
52(34) IMPURE SEGMENT SIZE; 54(36) PURE SEGMENT SIZE 
(ATF. ME) H (ATF. ed 
56 (38) SYSTEM SPACE { 58(3A) ROLL COUNT 
(ATF .SYS) H (ATF .ROLL) 
60(3C) USER CPU TIME (ATF .CPU) 
64(40) OS CPU TIME 
68(44) 
—------ RESERVED “== 
72(48) 
uote) WAIT TIME(ATF .WTIM) 
seO (30) “ROLL QUEUE TIME(ATF .RLTM) 
84(54) 1/0 COUNT FOR CLASS O(ATF.IOCT) 
88(58) NUMBER OF BYTES TRANSFERRED FOR CLASS 0O 


(ATF . [OXF ) 
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ATF FORMAT FOR TASK COMPLETION (ATYP.TSK) AND TASK DATA 
OVERFLOW ACCOUNT RECORD TYPES (Continued) 


ee ie ee ee Re tee attain tithe ee onetime tiated teat 


| 0(0) RECORD TYPE } 2(2) ACCOUNT NUMBER 

i (ATF .TYPE) 1 (ATF .ACCT) 
[92(8¢).~+~«ST/O COUNT FORCIASS 1S™St*~C~S~S 
| 96(60) NUMBER OF BYTES TRANSFERRED FOR CLASS 1 
| ooe4) SS I/O COUNT FOR CLASS 200—™S 
| 104(68) NUMBER OF BYTES TRANSFERRED FOR CLASS 2 — 
| 10a(ec) I/O COUNT FOR CLASS 30” 
| 112(70) | NUMBER OF BYTES TRANSFERRED FOR CLASS 30 
1 116(74) eee 
| 120(70) FILLER a 
| 124(7¢) Oe 


ao cae OO SR RS SO Se ee eee me SU eS ee a eS Oe Ore ep) wees ee mcm em mem my eee we Re SD ee Su eee mn Sm nee me em em ote eee mee SP 
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ATF FORMAT FILE RENAMING ACCOUNT RECORD TYPE 


ae ee aE re ca nah AN ST BO oN sap Ns mS mS) mms nS USS Pom em Seu mes remem ne ee mee Seem eg meme SC DO mae oY OO OO ee 


} 0(0) RECORD TYPE } 2(2) ACCOUNT NUMBER } 
(ATF. TYPE) ! (ATE. ACCT) 
H ses eee Sci ss BS ae Si Ea Sac a nes a Na ee ea a a ei Lee aes ns Seve Laas sco ao el aoe) et aes es “ee ics ew vases ae lr es ain cds et eas i 
H 4(4) CURRENT DATE AND TIME (ATF. CarM) | 
i Da Suan Dae msl cs “a a ea hae ct, i lw ah, lsc sm i, Sa suo: “w= i os ml“) Sa ls eh oa Ge “di av a a eis H 
; 8(8) VOLUME NAME (arr. VOL) H 
|= oS Ses Sac “Sala eh a cate ek Sey (bi i hm i hes“ nl Ss a! Mi sae. a | ae Ff sp as Maw, a a ns H 
f L2(C) FILENAME (First Word) { 
{ (ATF. ENE) { 
FS ea eas re ge ee a a pe ee eee eee rr en ia Saas ere eo | 
{ 16(10) MESSAGE POINTER FOR SVC “6 H 
H (ATF .MSGP ) H 
[raps oemiicieiciia a ala aaly a A ig i dn dio ee ae a 
} 20(14) FILENAME (Second Word) H 
{ (ATF .ENM2) | 
ee Se ee a ee ee ee ee ee 
H 24(18) EXTENS ION H 
i (ATF .EXT) H 
PSS ee ee SS ee See ea eee ee eet ee eee ee ee H 
{ 28(1C) NUMBER OF RECORDS i 
H (ATF .RECS) { 
Ee ee ge a ae en ee ee re eee ee ee et ee ae ee i 
{ 32(20) NUMBER OF SECTORS 
H (ATE.SECS) { 
a aaa ge a a rs lca as acta 
{ 36 (24) FILE CREATION DATE i 
H (ATF .CDAT) H 
| a ta aa sam es en cs a ae Sea Ne i a te an ee aes Shes he dl a (ea a a as a aa a ca nc H 
} 40(28) 
|------ NEW FILENAME 2 2—_ == 
| 44(2C) 
H (ATF .NWFN) H 
H si cs als as ay“ ey eo: ea, cy cad. "aSin Saas Sn gs Sn ad i ss a sen Su, ks acs co's (Sissi lig Fc (nny as ks "eed “eep i: So.“ Sn iain’ Sa Sy eos Swab s | 
| 48(30) EXTENS ION i 
H (ATE NWEX ) H 
i ass a cs Fs a can wae ets mise “tym i ‘ems 7m“ ca <a Se os co pr ta symone at <tr “am "emi na “ea nan ces Sos lie "Sei al ea asc i 
H 52(34) ACCOUNT NUMBER ;} 54(36) FILLER { 
i Gale NWEO) H { 
Spee reece rene eee trae Pal ee ee enw a ge am Ege OS ta 
~~ 56(38) ID OF TASK Y 
J------ THAT RENAMED FILE = ====== H 
| 60(3C) (ATF .TKID) H 
Peer eS ae SSS Ss SSA er Aer SSS eee ne ieee eee en aa i 
H oaen) 
peer ee ES 
ou FILLER ‘and 
an ~~ 
pe H 
H 124(7¢) 
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ATF FORMAT FOR FILE DELETION RECORD TYPE 


cect ie rneell iden aerate li nee Di ane eM ce e e ery 


0(0) RECORD TYPE } 2(2) ACCOUNT NUMBER 
(ATF .TYPE) | (ATF .ACCT) 
4(4) CURRENT DATE AND TIME (ATF. ea) 
8(8) VOLUME NAME (AFT.VOL) 
12(C) FILENAME (First Word) 
CATE ee) 
16(10) MESSAGE POINTER FOR sve 6 
(ATF. MSGP ) 
20(14) FILENAME (Second Word) 
(ATF. EN) 
24(18) EXTENS [ON 
(ATF .EXT) 
28(1C) NUMBER OF RECORDS 
(SIE: RECS ) 
32(20) NUMBER OF SECTORS 
(ATE.SECS) 
36(24) FILE CREATION DATE 
(ATF .CDAT) 
40(28) 
SS FILLER nee Ec 
44(2C) 
48(30) 
52(34) 


Ol I TE nee en 


56(38) : ID OF TASK 

~~ THAT DELETED FITE = 
60(3C) (ATF. hou. 

64(40) 


ee ee] 


ae ne NN eee eee ee ee ee 
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| APPENDIX E 
MULTI-TERMINAL MONITOR (MTM) OPERATOR COMMAND SUMMARY 


LOAD .MTM,fda 


TASK .MIM 


START ,AUF=fd [ATF=fd ] [ | TERMINAL= (£4, [;fdo,..-,fdg] | 


[BATCH=(n,fd)] [ PAGE=-fa] 


WAITS 
TERMINAL 


STATUS|,< BATCH 


USED [fd,] 


TELL 
userid message 
MESSAGE 


BROADCAST message 


device: 
CH n [fd] 


TERMINATE device: 


REMOVE 
BATCH n 


nl 
QUIESCE 

PURGE fd 
INQUIRE [€d] 
SUBMIT fd 


ATF fa 
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A 


Account Limit 
Account number 


Accounting data 
job related 
task related 
terminal user access to 
Accounting facility 
system requirements 
Accounting transaction file 
ACCOUNTS command 
ADD command 
ADD parameter 
Assistant task 
ATF parameter 
-MTM command 
MTM START command 
ATF. See accounting 
transaction file. 
AUF parameter 
AUF. See authorized user 
file. 
Authorized user file 
Authorized user utility 
ACCOUNTS command 
ADD command 
building and starting 
CHANGE command 
CREATE mode 


DELETE command 
END command 

LIST command 

MODE command 
PAUSE command 
PRIVILEGE command 
REPORT mode 


START command 
TOTAL command 
UPDATE mode 


B 


BATCH parameter 
-MTM ADD 
-MTM REMOVE 
MIM START command 
-MTM STATUS 
Batch processing 
CPU limit 
CPU limit per user class 
I/O limit 
job pause 
relative default priority 
BROADCAST parameter 
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INDEX 
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CDBUFSIZ 
CHANGE command 
Command buffers 


CONBFSZ 
Concurrent users 
Console buffers 


CONTINUE command 
Count of I/O transfers 
CPU limit 
batch jobs 
per account number 
per accounting user class 
CPU time 
CPULIMIT 
CREATE mode 


CSBFSZ 
CSS levels 


D 
Data collection 


Data structures 

Date and time submitted 
Date formats 

Default volume 

DELETE command 

Dynamic scheduling 


Elapsed time 
END command 
End of task codes 


F 
File descriptor, task loaded 
from 
File descriptors 
Forced roll 
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Global variables 
new 
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aescription 

end of task codes 
error messages 
establishing accounts 
operating procedures 
system generation 
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Memory requirements 
Memory used by a task 
Message buffers 
MESSAGE parameter 
MODE command 

-MTMASST task 

-MTM command 
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H | MTM sysgen options 
! (Cont inued) 
HASP interface 2-39 | batch job priority 2-28 
! command buffer size 279 
H console buffer size 2-7 
I ' CPU limit per user class 2-40 
\ default user volume 2-27 
I/O class table 2-10 } forced roll 2-31 
I/O control block 2-11 4 global and local 
I/O Limit ! variables 2-36 
per accounting user class 2-42 =} HASP interface 2-39 
per I/O class 2-10 | I/O class table 2-10 
INQUIRE parameter 5-7 H I/O count limit per user 
Interactive processing class 2-42 
CPU limit 3-4 ! internal variables 2-38 
3-10 |} memory requirements 2-46 
3-13 !} MTM link 2-11 
CPU limit per user class 2-40 |} new global variables 2-37 
default priority 2-28 } number of command buffers 2-15 
I/O Limit 2-42 | number of concurrent 
signon time limit 3-4 H users 2-20 
3-10 } number of console buffers 2-13 
3-12 } number of CSS levels 2-17 
Internal variables 2-16 } number of message buffers 2-18 
2-38 |} number of sector length 
IOTAB macro 2-10 ; buffers 2-19 
' OS/32 accounting facility 2-25 
' prompt device 2-21 
J,K H prompt sequence 2-22 
H scheduling 2=32 
Job number 4-5 ! sector buffer size 2-6 
4-10 ! SPL/32 interface 2-35 
H task queue size 2-24 
! version identification 2-45 
L ! MTM version identification 2-45 
1 MTM. See multi-terminal 
LINK OPTION command 2-12* =| monitor. 
4-2 1  .MTMASST task - 
LINKOPT 2-11 | =MTMMAIN - 
LIST command 3-16 ;| MTMPARMS.MAC - 
Local variables 2-36 |} MTMSGN - 
Logical unit 2-11 | #MTMSGN command - 
| MTMSGN.CSS - 
{ Multi-terminal monitor 
M H data structures 
i 
i 
i 
1 
H 
I 
i 
examples ~ i N,O 
format = | 
parameters - ! NCONBFS 2-13 
MT link -11 }|.: NCSBFS 2-15 
MTM operating procedures i NCSSLVS 2-17 
loading and establishing | NMSGS 2-18 
MTM 5-1 | NSECTS 2-19. 
MIM START command 5-2 | Number of commands entered 4-5 
MTM START command 4-2 ! Number of CSS calls executed 4-5 
5-2 | Number of DISPLAY FILE 
MTM sysgen options 2-4 { commands 4-6 
batch job CPU limit 2-8 | Number of tasks executed 4-5 
batch job pause 2-26 |} NUSERS 2-20 
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P Subtask scheduling 


dynamic 2-32 

PAGE parameter 5-3 priority 2-32 
PAUSE command 3-19 PSM 2-33 
Priority scheduling 2-32 Subtasks of MT Lat 
Priority scheduling mechanism 2-33 Sysgen options 
PRIVILEGE command 3-20 2-4 
Privileges 0S/32 1-3 

account 3-21 Sysgen parameter file 2=2 

account 255 3-11 SYSSTRUC.MLB macro library 2-4 

default 3-11 System generation 
PRMTDEV macro 2-21 MTM 2-1 
PRMTSEQ macro 2-22 4-2 
Program development feature 2-16 OS /32 1-3 
Prompt device 2-21 4-2 
Prompt sequence 2°22 System requirements 1-2 
PSM. See priority 4-1 


scheduling mechanism. 


PURGE parameter 5-7 
T 
Q Task date and time 4-8 
Task queue 2-24 
QUESIZE 2-24 Task termination 4-11 
QUIESCE parameter 5-6 TCB counter overflow 4-11 
TELL parameter 5-5 
TERMINAL parameter 5-2 
R 5-5 


Terminal prompt 


REMOVE paramater 5-6 device name 922 1: 
Renamed and deleted files 4-6 sequence 2-22 
REPORT mode 3-5 TERMINATE parameter 5-6 
3-7 Time formats 4-3 
Reporting utility 4-1 TOTAL command 3-26 
Roll count 4-9 
Roll time 4-8 
U 
s UCPULIM macro 2-40 
UIOLIM macro 2-42 
Secondary directory 2-6 UPDATE mode 3-5 
Sector buffer 2-6 3-7 
2-19 USED parameter 5-5 
pathic 2-25 User identifier 4-6 
SGN. BTCP 2-26 4-8 
Say suse ee User supplied information 4-10 
SGN. @INT 2-38 
SGN .MVOL 2-27 
SGN. PRIO 2-28 ¥ 
SGN. ROLL 2-31 : 
SGN.SCHR 2-32 Variables Glia 
SGN. SPL 2-35 Grobe . 
SCN .VAR 2-36 internal 2-38 
Signoff time 4-11 local a 
Signon time limit | 3-4 new global 7 oe 
Signon/signoff date and time 4-5 VERSION macro - 
SPL/32 interface 2-35 
START command 
authorized user utility 3-5 W-2 
MTM 5-2 . 
STATUS parameter 5-5 Wait time 4-8 
SUBMIT parameter 5-7 WAITS parameter 5-5 
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